open-index/open-npm huggingface dataset:
npm package: @jx3box/jx3box-dict
Description: JX3BOX剑网3繁简转换专用词库
Latest version: 2.2.5

# JX3BOX-DICT

## 说明

这个项目用于将剑网3中的“宏”或“团队监控数据”准确地从简体中文转为繁体中文。  

网上直译的词库将可能导致宏无法运行或数据无法正常监控。

## 使用

你可以通过 https://www.jx3box.com/app/translator 在线转译你的作品。  

或直接引用 https://cdn.jsdelivr.net/gh/JX3BOX/jx3box-dict@master/dict.json 构建你自己的项目

## 贡献

请在 `src/JX3BOX` 目录下根据新建一个 UTF-8 编码的 `TSV` 文件（命名可以根据具体作用而定），并在其中写入你要增加的名词

文件内容形如 `简体文本\t繁体文本`，`\t` 为制表符，每行一组

之后运行 `npm run-script build` 生成输出数据，向本仓库发送 PR 即可

你也可以通过 https://github.com/JX3BOX/jx3box-dict/issues 提交需要补充的词汇。

## 贡献名单

感谢以下小伙伴对词库的辛勤整理&贡献：

+ 南宫伯

+ BILIN 

+ WUSISANERYI

+ CoolguyNH
npm package: @jx3box/jx3box-editor
Description: JX3BOX Article & Editor
Latest version: 3.1.3

## 组件清单

名称|说明|是否支持全局注册
---|---|---
Article|文章详情|✅
Tinymce|编辑器|❌
Markdown|MD编辑器|❌
Upload|上传(按钮+弹窗)|❌
UploadAlbum|上传(仅图片)|❌
BoxResource|魔盒资源|❌
Resource|剑三资源|❌
---|---|---
Buff|剑三Buff|✅
Skill|剑三Skill|✅
Item|剑三物品|✅
ItemSimple|剑三物品(简化)|✅
Npc|剑三NPC|✅
GameText|剑三文字|✅


## 组件文档
+ [Article](./docs/article.md)
+ [Tinymce](./docs/tinymce.md)
+ [Markdown](./docs/markdown.md)
+ [Upload](./docs/upload.md)


## 开发
```
$ npm install
$ npm run dev //本地调试
```
npm package: @jx3box/jx3box-emotion
Description: 通用表情插入与渲染模块
Latest version: 1.3.0

## usage

1. 表情渲染

```js
import JX3_EMOTION from '@jx3box/jx3box-emotion'

const ins = new JX3_EMOTION(str)

// return html
ins.code
```

2. 表情组件

该组件会 `emit` 一个 `selected` 事件，向上传递一个参数，其值为选中的表情的key

```js
import Emotion from '@jx3box/jx3box-emotion/src/Emotion.vue'

<Emotion @selected="handleSelected" />

const handleSelected = (key) => {
  // your code
}
```
npm package: @jx3box/jx3box-facedat
Description: JX3BOX Facedat viewer
Latest version: 2.7.3

# Facedat
捏脸分析公共组件

## Step.1 Install
```
npm install --save @jx3box/jx3box-facedat
```  

## Step.2 Import
+ 引入模块
```javascript
import Upload from "@jx3box/jx3box-facedat/src/Upload.vue"
import Facedat from "@jx3box/jx3box-facedat/src/Facedat.vue"
```
## Step.3 Usage
+ 使用模块
```html
<Upload @success="handleSuccess"/>
<Facedat :data="json" :lock="false"/>
```

## 测试地址
1. 应用页
2. 新数据渲染页
3. 旧数据渲染页

## 数据构建
1. 本地数据库构建，默认使用facedecals__作为主
2. decal__作为价格补充列
3. 导入gb2313，关联RoleType/Type/ShowID
4. 导出csv
5. 执行`npm run face`生成json

## Todo
涉及项目：app、share
1. 根据游戏版本进程，需要更新version.json
2. 根据游戏更新贴花，需要更新raw内容并重新build，同时更新使用项目库
npm package: @jx3box/jx3box-map
Description: JX3BOX Game Map
Latest version: 1.1.4

# @jx3box/jx3box-map

用于各种需要在地图上展示点位的场合  

## QuickStart

```js
import Jx3boxMap from '@jx3box/jx3box-map/src/components/Map.vue
```

```html
<jx3box-map :map-id="8" :datas="datas"></jx3box-map>
```

```js
export default {
    name: "App",
    components: {
        Jx3boxMap,
    },
    data: () => ({
        datas: [
            {
                x: 9655,
                y: 13231,
                title: "测试",
                content: "测试内容11<br />22",
            },
        ],
    }),
};
```

## props

组件props作用。

### mapId

当前所展示的地图

### datas

在地图上的点位，是一个对象数组。其中的对象的属性如表所示

| 属性名  | 描述             | 必填 | 栗子    | 备注                                           |
| ------- | ---------------- | ---- | ------- | ---------------------------------------------- |
| x       | 坐标x点          | 是   | 114514  |                                                |
| y       | 坐标y点          | 是   | 1919810 |                                                |
| title   | 悬浮框标题       | 否   |         |
| content | 悬浮框显示的内容 | 否   |         |
| focus   | 是否展示这个点   | 否   | true    | Boolean，多个数据focus都为true时只会展示第一个 |

### overview 总览模式

默认情况下，overview为true。  

**当overview为true时：**  
组件会把整个地图缩放以适应容器大小，尝试展示完整的地图与点位。  

**当overview为false时：**  
组件会以地图的原尺寸展示地图，仅展示以特定点位为`中心`的周围一部分点位。  
可以在datas内的对应对象设置focus为true指定中心点位。  
或者给组件传入focus属性，值是要展示的点位在datas内的索引。  
如果不通过任何方式指定要展示的点位会直接取第一个。  

### map-draggable

是否允许用户拖动地图，仅在overview为false时生效。  
此时用户可以通过拖动地图来改变可见区域  
即默认会以focus点为中心，但是用户可以拖动来改变展示的区域  

### point-draggable

是否允许用户移动点位。  
此时用户可以通过拖动点位来改变点位的坐标。  

### map-follow

用户拖拽点位之后是否让地图跟随被拖拽的点居中。

### trim-border

是否移除地图边框。  
西山居的中地图图片是有边框的，默认不展示边框，如果需要展示可以设为`true`

## 事件

### map-move

用户拖拽地图之后触发

### point-move

用户拖拽点位之后触发

## 方法

### pointPosition(point) -> {left: ..., bottom: ...}

获得一个坐标（游戏坐标）在当前地图的中地图偏移（像素）

### gamePosition(left, bottom) -> {x: ..., y: ...}

和上面相反

### initInnerOffset(point)

移动inner，使得一个点尽可能居


## slots

允许一些部分的自定义slot。

### title

地图上方的名称部分

### point

地图上的点位元素，默认是一个带popover的小红点，如果需要替换的话需要自己给上popover

#### popover

如果使用默认的point，可以用popover这个slot来替换的默认的popover里的内容
npm package: @jx3box/jx3box-page
Description: ## Install  ``` npm install @jx3box/jx3box-single ```
Latest version: 0.7.6

# Single

## Install 
```
npm install @jx3box/jx3box-single
```

## Import 
```javascript
import Single from '@jx3box/jx3box/single/src/Single.vue'
```

## Usage
```html
<Single :post="post_data" :author="author_data" :stat="stat_data"></Single>
```

## Dev

```
$ open http://localhost:8080/list
$ open http://localhost:8080/single/$id
```
npm package: @jx3box/jx3box-petmap
Description: JX3BOX PVX Pet Map
Latest version: 0.1.11

## source

- zhcn.jx3dat   
    插件源数据

## tools

- PetDataToJBData.py
    网站数据导出工具（需要配合改过的 [lua-data](https://github.com/whc2001/luadata/tree/dev)）

- MiddleMapScaleData  
    地图坐标与缩放数据导出工具

## output

- PetPOIs.json  
    网站用的输出

- MapScales.json  
    地图坐标与缩放输出
npm package: @jx3box/jx3box-player
Description: 玩家角色信息
Latest version: 0.1.6

# Player

推栏角色信息渲染组件

## 装分计算
```装备分数 = 品质 * 品质系数 * 部位系数```
藏剑：(轻剑+重剑)/2

### 品质系数

| 品质 | KEY | 系数 |
| ---- | --- | ---- |
| 白色 | 1   | 0.8  |
| 绿色 | 2   | 1.4  |
| 蓝色 | 3   | 1.6  |
| 紫色 | 4   | 1.8  |
| 橙色 | 5   | 2.5  |

### 部位系数

| 位置 | KEY | 系数 |
| ---- | --- | ---- |
| 主武 | 0   | 1.2  |
| 次武 | 1   | 1.2  |
| 暗器 | 2   | 0.6  |
| 衣服 | 3   | 1    |
| 帽子 | 4   | 0.9  |
| 项链 | 5   | 0.5  |
| 戒指 | 6   | 0.5  |
| 戒指 | 7   | 0.5  |
| 腰带 | 8   | 0.7  |
| 腰坠 | 9   | 0.5  |
| 裤子 | 10  | 1    |
| 鞋子 | 11  | 0.7  |
| 护腕 | 12  | 0.7  |
npm package: @jx3box/jx3box-single
Description: ## Install  ``` npm install @jx3box/jx3box-single ```
Latest version: 0.0.3

# Single

## Install 
```
npm install @jx3box/jx3box-single
```

## Import 
```javascript
import Single from '@jx3box/jx3box/single/src/Single.vue'
```

## Usage
```html
<Single :post="post_data" :author="author_data" :stat="stat_data"></Single>
```
npm package: @jx3box/jx3box-talent
Description: 奇穴模拟器
Latest version: 1.3.13

# 奇穴模拟器

> 讲个笑话，之前写的时候，只有上帝和我知道我写了些什么  
> 现在，只有上帝知道了……  
> 先酱，给一个无限期的承诺，或许有一天我会重构。  

## 测试

```bash
npx vite --port=4000

# 访问：http://localhost:4000/test/index.html
```

**注意**：由于vite支持大多数新版本的特性，但是现有的大多数前端项目依旧使用的webpack搭配旧版本的loader，所以某些新语法可能会爆炸。发版前请先将index.js内容复制到某个前端项目的node_modules内看能不能跑起来~

## 使用空白配置

```javascript
let talent = new JX3_QIXUE()
```

## 使用指定配置

返回一个promise,参数为该talent实例

```javascript
let talent = new JX3_QIXUE({
    "xf":"冰心诀",
    "sq":"1,2,4,1,2,3,1,2,3,4,4,4",
    "editable":true
});
```

## 重载配置/方案

返回一个promise,参数为该talent实例

```javascript
talent.load({
    "xf":"冰心诀",
    "sq":"1,2,4,1,2,3,1,2,3,4,4,4",
    "editable":true
})
```

## 全局事件

任何修改，会触发`JX3_QIXUE_Change`全局事件，传递talent实例作为参数

```javascript
$(document).on("JX3_QIXUE_Change", function(e, ins) {
    let __data = {};
    __data.version = ins.version;
    __data.xf = ins.xf;
    __data.sq = ins.sq.join(",");
    let str = JSON.stringify(__data);
});
```

## 其它属性

![Talent](./talent.png)
npm package: @jx3box/jx3box-ui
Description: JX3BOX Vue3 UI
Latest version: 2.1.10

# 概述

1. App.vue 用于平时做组件开发临时预览
2. Storybook 用于协作开发共享，注意编写好 props 注释

## 模块

### 全局

-   CommonHeader 公共头
-   Breadcrumb 面包屑
-   Main 默认内容框架（非必须）
-   LeftSidebar 左侧边栏（非必须）
-   LeftSideToggle 左侧边栏触发器（非必须，可独立使用）
-   RightSidebar 右侧边栏（非必须）
-   CommonFooter 公共底
-   SuspendCommon 移动侧浮窗底（此组件需要手动引入）

### 内容单页 single

主要是用于详情页的展示内容

-   CmsSingle 单页框架
-   Author 侧边栏作者信息整合
-   PostDirectory 目录
-   PostHeader 创作信息
-   Creators 联合创作
-   Collection 小册
-   Thx 交互组件
-   SimpleThx 交互组件简化版（仅 PVP 栏目使用，需要手动引入）
-   Comment 评论
-   RightAffix 固钉
-   PostGuide 快速跳转至上下篇
-   PostVersion 修改历史
-   PostCollection 关联小册

### 筛选模块 list

主要用于各栏目的列表筛选

-   clientBy 客户端筛选
-   markBy 标记筛选
-   menuBy 通用筛选
-   orderBy 排序筛选
-   tagBy 标签筛选
-   topicBy 主题筛选
-   versionBy 版本筛选
-   zlpBy 资料片筛选

### 百科模块 wiki

-   GamePrice 游戏价格组件
-   WikiPanel 百科面板
-   WikiComments 百科评论
-   WikiRevisions 百科修订

### 其他

-   UserPop 搜索用户弹窗