MistMC团队技术规范

客服工作职责

  1. 玩家支持：

    • 通过在线聊天、QQ等方式，解答玩家在游戏过程中遇到的问题和疑问。
    • 提供技术支持，指导玩家解决游戏安装、登录、连接等技术问题。
    • 记录玩家的常见问题，编写FAQ文档，提升服务的效率。

  2. 问题解决：

    • 及时处理玩家的投诉和反馈，分析问题根源并提供有效的解决方案。
    • 协调与技术团队的沟通，确保技术问题得到快速解决。
    • 跟踪问题解决进度，确保玩家的问题得到彻底解决并反馈结果。

  3. 社区管理：

    • 维护服务器的和谐氛围，管理和监督游戏内外的玩家行为，确保遵守服务器规则。
    • 处理玩家间的纠纷，调解争端，确保游戏环境的公平和友好。
    • 定期巡查游戏服务器，发现并处理违规行为。

  4. 信息收集：

    • 收集玩家的建议和意见，整理并向管理团队反馈，以便优化游戏体验。
    • 分析玩家反馈的数据，提出改进建议，协助提升服务器的服务质量。
    • 参与玩家调查，了解玩家需求和满意度，制定改进计划。

活动策划工作职责

  1. 活动设计与策划

    • 设计并策划各种有趣且具有挑战性的游戏活动，包括但不限于比赛、探险、建造比赛等。
    • 确保活动具有创新性和可玩性，能够吸引不同类型的玩家参与。

  2. 活动实施与管理

    • 制定详细的活动方案和时间表，确保活动按计划进行。
    • 组织和协调活动的各个环节，确保活动顺利进行。
    • 实时监控活动进展，及时解决活动过程中出现的问题。

  3. 玩家互动与反馈

    • 积极与玩家互动，了解玩家需求和建议。
    • 收集活动反馈，分析活动效果，不断优化和改进活动内容。

  4. 宣传与推广

    • 制定活动宣传计划，通过服务器内公告、b站等渠道进行宣传。
    • 制作活动宣传材料，如宣传图、视频等，吸引更多玩家参与。

  5. 数据分析与报告

    • 记录和分析活动数据，评估活动效果。
    • 定期撰写活动总结报告，提出改进建议。

官网和文档维护要求

需要熟练掌握git与上传github的相关操作

需要熟练掌握markdown的编写方法

请熟读Nitwikit编写规范以编写官网的教程等内容

服务器插件编写规范

1. 编码规范

  • 命名规范:

    • 类名使用大驼峰命名法（如MyPlugin）。
    • 方法名和变量名使用小驼峰命名法（如getPlayerName）。
    • 常量名使用全大写加下划线（如MAX_PLAYERS）。

  • 注释:

    • 类和方法必须有Javadoc注释。
    • 复杂逻辑应有行内注释。

2. 日志记录

  • 使用getLogger()方法记录日志。
    1
    getLogger().info(”XX插件已加载“);

3. 插件依赖

  • 在plugin.yml中声明插件依赖：
    1
    depend: [依赖插件名称]

4. 测试与调试

  • 在本地服务器上进行充分测试，确保插件无错误。
  • 使用System.out.println或日志记录进行调试。

5. 发布到GitHub

请使用使用GitHub Desktop发布（若会git可忽略）

可能需要妙妙工具辅助上网

  1. 创建GitHub仓库:

    • 登录GitHub并创建一个新的仓库。
    • 初始化仓库时，可以选择添加README.md和.gitignore文件（选择Java模板）。

  2. 克隆仓库到本地:

    • 打开GitHub Desktop。
    • 点击“File” > “Clone repository”。
    • 选择你刚刚创建的仓库并克隆到本地。

  3. 将项目文件添加到本地仓库:

    • 将你的插件项目文件复制到本地克隆的仓库目录中。

  4. 提交和推送代码:

    • 在GitHub Desktop中，添加所有更改。
    • 输入提交信息（如“初次提交”）。
    • 点击“Commit to main”。
    • 点击“Push origin”将代码推送到GitHub远程仓库。

  5. 发布版本:

    • 在GitHub仓库页面，点击“Releases”选项卡。
    • 点击“Draft a new release”按钮。
    • 填写版本号（如v1.0.0）、标题和描述。
    • 上传通过Maven打包生成的插件JAR文件。
    • 点击“Publish release”按钮发布新版本。

  6. 编写README文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
# MyPlugin

MyPlugin是一个用于岚域我的世界服务器的插件，提供了一些有用的功能。

---

## 功能介绍

- 功能1：描述功能1的作用。
- 功能2：描述功能2的作用。
- 功能3：描述功能3的作用。

## 安装

1. 下载最新版本的插件JAR文件。
2. 将JAR文件放入服务器的`plugins`目录。
3. 重启服务器。

## 使用

### 命令

插件提供以下命令：

- `/mycommand` - 执行某个功能。
  - **用法**: `/mycommand <参数>`
  - **示例**: `/mycommand example`

### 权限

插件使用以下权限：

- `myplugin.use` - 允许使用插件的基本功能。
  - **默认**: 所有玩家
- `myplugin.admin` - 允许使用管理员功能。
  - **默认**: 仅管理员

### 配置

插件支持以下配置选项：

```yaml
# config.yml
option1: value1
option2: value2
  1. API编写规范

1. 方法设计

  • 方法签名: 方法名应清晰描述其功能，避免歧义。
  • 参数: 参数列表应尽量简洁，必要时使用对象封装多个参数。
  • 返回值: 返回值类型应明确，避免使用模糊类型（如Object）。

2. Javadoc 注释

每个API方法都应有详细的Javadoc注释，包含以下信息：

  • 方法描述: 简要描述方法的功能。
  • 参数: 使用@param标签描述每个参数。
  • 返回值: 使用@return标签描述返回值。
  • 异常: 使用@throws标签描述可能抛出的异常。

示例：

1
2
3
4
5
6
7
8
9
10
/**
 * 获取玩家的名称。
 *
 * @param playerId 玩家ID
 * @return 玩家名称
 * @throws PlayerNotFoundException 如果找不到该玩家
 */
public String getPlayerName(String playerId) throws PlayerNotFoundException {
    // 方法实现
}

3. 异常处理

  • 自定义异常: 对于特定错误情况，定义自定义异常类（如PlayerNotFoundException）。
  • 抛出异常: 在方法签名中声明可能抛出的异常，并在方法内部适当位置抛出。

示例：

1
2
3
4
5
public class PlayerNotFoundException extends Exception {
    public PlayerNotFoundException(String message) {
        super(message);
    }
}