公会需求文档(0815)

【我世界】公会系统需求文档草案
1. 设计目的
搭建用户公会系统底层模块，提供玩家更丰富的交互方式和游戏体验。

2. 开发方向
以魔兽世界的公会系统为基础蓝本，添加特色内容，形成有独立特色的公会组织方式和玩法。

3. 系统概述
3.1. 系统功能
3.1.1.系统消息
每个功能成功操作都应有相应的系统消息。

格式为$player$已经#action#和$player1$己将$player2$#action#两种，在提示频道用特别颜色显示。

除设置昵称是对操作用户本地客户端广播外，其他均是对公会所有成员广播。

该类MSG，除“设置昵称”是对操作用户本地客户端广播外，其他均是对公会所有成员广播。

3.1.2.公会回收
公会人数小于10，系统自动触发回收倒计时。

若该现象持续20天以上（>=20天），系统将会自动回收公会，对其执行解散操作。

3.1.3.删除角色处理
角色如果为一个公会的会长，在该角色删除时应有二次确认面板弹出提示不能删除。

3.2. 基础
3.2.1.公会相关数据
公会表中应记录的数据有：
●UID，为系统分配的唯一标识
●ID，公会ID为按建立时间从小到大递增的数值，与系统分配的UID不同，最大为9999
●公会名
●公会等级(后续内容)：成功创建公会后，默认为1级。

公会等级上限，目前暂定为5级；
●公会金库金额：包括当前金额/升级金额，公会升级消耗资源之一（预留数据，后续开发）；
●公会繁荣度：类似于角色升级经验值，包括当前繁荣度/升级繁荣度，也是公会升级消耗资源之
一（预留数据，后续开发）；
●公会地图ID（预留数据，后续开发）；
●公会建筑（预留数据，后续开发）；
●公会公告信息：仅公会成员可查看的信息，字符长度不超过128；
●公会宣告信息：所有用户均可查看的信息，字符长度不超过128；
●公会成员数：包括已有成员数/成员上限数，不同等级的公会，成员上限数也不同，各等级对应
成员上限数，具体为：
a）1级：60人；
b）2级：80人；
c）3级：100人；
d）4级：130人；
e）5级：160人。

●公会成员列表
●成员申请列表，最多保存64个会员的信息，每个申请成员的信息在申请列表最多保存1天，新
添加的会员信息将自动替代表中保存的最早的会员信息，申请列表中记录的信息不能重复。

列
表信息只对申请人在线时有效。

●公会会长ID
●同盟公会ID(5个)
●敌对公会ID(3个，但UI表现上仍为5人)
●公会同盟申请列表，最多保存5个公会的信息，每个申请公会的信息在申请列表最多保存1天，
新添加的公会信息将自动替代表中保存的最早的公会信息，申请列表中记录的信息不能重复。

●公会敌对申请列表，最多保存5个公会的信息，每个申请公会的信息在申请列表最多保存1天，
新添加的公会信息将自动替代表中保存的最早的公会信息，申请列表中记录的信息不能重复。

●公会活跃度（预留数据，后续开发）。

3.2.2.个人相关数据
个人信息表应记录的数据有：
●归属公会id；
●官阶，公会中成员官阶从高到低分为5个等级：会长，副会长，官员，会员，平民。

●贡献度（挂起）
●昵称：长度为12个字符
●惩罚标识，（通过BUFF实现，client需有BUFF图标标识）记录内容为时间：
1.惩罚状态下，用户无法执行加入公会（主动申请、被邀请）、创建公会相关功能；
2.用户执行主动退会、解散公会行为时，会获得惩罚状态，包括；
3.惩罚状态的持续时间，暂定为24h（即1天），从执行b点相关行为开始计时。

●活跃时间（挂起，后续开发）。

备注：实际上，公会成员结构中，没有“平民”的概念，因为平民即未加入公会的角色。

系统时间与惩罚标识相比不大于一天的情况下，不能进行创建公会和加入公会的操作。

惩罚时间为1天。

3.2.3.权限相关数据
功能操作的权限用表记录，个人的官阶决定了公会相关功能操作的权限：
3.2.
4.相关数据的限制
每个公会限定有：
●会长1名
●副会长2名
●官员数量10个
●公会总人数，目前暂定为不超过160人（5级）。

●公会名称的长度不应超过15个字符。

4. 界面
4.1. 基础界面
见相关文件。

4.2. 界面功能
4.2.1.公会管理面板
●界面上相关功能按钮只有玩家拥有相关权限时才显示为可点击状态
●公会成员列表分列显示的信息有：成员名，成员官阶，成员等级，成员职业，成员昵称，成员
贡献度，成员最后下线时间。

●公会成员列表默认显示为所有成员，在勾选后显示在线成员，对非在线角色列表，需做“灰态”
处理。

●公会信息内显示公会公告的内容（仅为显示功能，若需对公告进行编辑，需点击“修改公告”
按钮，在单独的公告编辑栏面板进行操作）。

●点击列表顶部的按钮将对列表按相应内容进行排序操作，包括：
1.官阶
2.等级
3.职业
4.贡献度
5.最后下线时间
●点击预备会员按钮将弹出预备会员审核面板
●点击外交关系按钮将弹出外交关系面板
4.2.2.右键功能菜单
在目标面板右键菜单中，需加入“邀请入会”选项，点击后执行邀请入会操作。

4.2.3.搜索公会面板
●界面上相关功能按钮只有玩家拥有相关权限时才显示为可点击状态；
●公会列表分列显示的信息有：公会名，公会等级，公会人数。

●公会列表分页显示，每页显示13行公会
●查询按钮将搜索服务器公会列表，查询内容为输入框输入的ID，满足搜索条件的公会显示在公
会列表中。

查询内容为空时，返回全部公会列表，默认返回全部公会列表。

●上翻和下翻按钮将对列表内容进行翻页操作；
●搜索公会面板中部，显示为公会具体信息(挂起)、公会官职成员列表(显示会长和副会长)、公会
宣告内容；
●搜索公会面板右边部分，提供“申请加入”、“撤销同盟”、“设置敌对”、“取消敌对”功能，具
体详见第5节相关功能需求描述。

4.2.4.预备会员审核面板
●审核列表需要显示的信息有：申请列表中玩家名字，等级，职业
●审核列表显示公会审核列表中的玩家信息
●点击列表顶端的按钮将对列表内容进行排序操作。

4.2.
5.外交关系面板
●外交关系面板需要显示的内容有：公会敌对公会列表，公会同盟公会列表，公会外交关系申请
列表。

●外交关系申请列表中显示公会记录的公会同盟申请列表和敌对申请列表中的信息，用在申请外
交关系中显示“同盟”和“敌对”来区别信息来源。

●面板中的同意和反对按钮只有会长和副会长官阶可以点击。

●点选申请列表中的选项，再点击同意或反对按钮则返回对相应消息的操作信息。

5. 功能操作
5.1. 创建公会
5.1.1.相关限制
●公会归属必须为空
●官阶必须为平民
●等级必须达到30级。

（暂定）
●拥有布尔必须超过5000（暂定）
●公会名不能为空，且不能超过16个字符，不能包含敏感字和特殊字符
●公会名不能重复
●创建人不能处在惩罚标识的惩罚时间内
5.1.2.操作流程
●玩家在NPC处点击创建公会选项
●弹出输入框
●判断限制
●向公会列表添加记录，公会成员数+1
●将玩家信息的公会归属置为新分配的ID，将玩家的官阶设为会长。

●激活公会面板和公会频道。

5.2. 添加会员
5.2.1.相关限制
●官阶必须为官员，副会长或会长
●被邀请的玩家公会归属必须为空，官阶必须为平民。

●被邀请的玩家必须在线
●被邀请的玩家的名字不能为空且必须存在
●公会人数必须未到达上限
●被邀请的玩家不能在惩罚时间内
5.2.2.添加方式
有官阶用户，可通过下述方式添加会员：
●右键功能菜单：选定角色，通过点击右键菜单中的“邀请入会”选项，执行添加会员操作；
●添加会员按钮：点击公会管理面板中的“添加会员”按钮，在输入框中，输入要添加的角色名
字，点击“确定”，执行添加会员操作；
●预备会员审核：点击公会管理面板中的“预备会员审核”按钮，在审核面板中，选定已提交申
请的角色名字列表，点击“批准”，执行添加会员操作。

5.2.3.操作流程
●玩家在公会面板点击邀请按钮
●弹出输入框
●点击确认后判断限制条件
●向指定玩家发送消息，弹出确认框
●指定玩家点击确认后，将指定玩家的公会归属置为相应公会ID，官阶设为会员。

●将指定玩家的ID加入到公会成员列表，公会成员数+1
●激活公会面板和公会频道。

5.3. 开除会员
5.3.1.相关限制
●官阶必须为会长或副会长
●玩家在公会面板的成员列表中选择对象
●点击踢人按钮
●判断限制条件
●弹出二次确认框
●将指定对象的公会归属置空，官阶置为平民，贡献度置空，清除昵称
●将指定对象的ID从公会成员列表中删除，公会成员数-1
●取消指定对象的公会面板和公会频道
5.4. 退出公会
5.4.1.相关限制
●官阶不能为会长
5.4.2.操作流程
●玩家打开公会面板
●玩家点击退会按钮
●判断限制条件
●弹出二次确认框
●确认后，清除玩家的公会归属，官阶置为平民，清除贡献度和昵称。

●将玩家的ID从公会成员列表中删除，公会成员数-1
●取消玩家的公会面板和公会频道
●记录当前系统时间到惩罚标识字段。

5.5. 职位提升
5.5.1.相关限制
●操作成员官阶必须为会长或副会长；
●被提升的玩家的最终官阶不能高于或等于执行操作的玩家的官阶；
●被提升到的官阶必须还没有达到人数上限。

●玩家从公会成员列表中选择对象
●点击提升等级按钮
●判断限制条件
●将指定玩家的官阶提升一个等级；
5.6. 职位降级
5.6.1.相关限制
●官阶必须为会长或副会长
●被降级的玩家的官阶不能高于或等于执行操作的玩家的官阶；
●若操作目标当前官阶已经为最低等级（普通会员），则无法对其继续执行降级操作。

5.6.2.操作流程
●玩家从公会成员列表中选择对象
●点击提升等级按钮
●判断限制条件
●将指定玩家的官阶降低一个等级
5.7. 解散公会
5.7.1.相关限制
●官阶必须为会长
5.7.2.操作流程
●玩家在NPC处执行选项
●判断限制条件
●弹出二次确认
●将公会成员列表中所有成员的公会归属置为空，将所有成员官阶置为平民，将成员的贡献度置
空，昵称置空，将公会记录从公会列表中删除
●记录当前系统时间到玩家的惩罚标识字段
5.8. 编辑公会公告
5.8.1.相关限制
●官阶必须为会长，副会长或官员
●公会公告信息不能超过128个字符
5.8.2.操作流程
●玩家打开公会面板
●点击修改公会公告按钮
●判断限制条件
●弹出信息输入框
●玩家点击确定按钮后，修改公会公告信息。

5.9. 编辑公会宣告
5.9.1.相关限制
●官阶必须为会长
●公会宣告信息不能超过128个字符
5.9.2.操作流程
●玩家在NPC处执行选项
●判断限制条件
●弹出信息输入框
●玩家点击确定按钮后，修改公会宣告信息。

5.10. 职位转让
5.10.1.相关限制
●操作成员官阶，必须为会长或副会长
5.10.2.操作流程
●玩家从公会成员列表中选择对象
●点击让位按钮
●弹出二次确认
●确认后将被选择玩家的官阶设为执行命令的玩家的等级
●将执行命令的玩家的官阶设为会员
5.11. 申请入会
5.11.1.相关限制
●官阶必须为平民
●玩家不能在惩罚时间内
5.11.2.操作流程
●玩家在NPC处执行选项
●打开服务器公会列表面板
●玩家从列表中选择公会
●玩家点击申请按钮
●把玩家ID加入到被选择公会的申请列表中
5.12. 预备会员审核
5.12.1.相关限制
●官阶必须为会长、副会长、官员；
●被批准的对象公会归属必须为空，官阶必须为平民。

5.12.2.批准流程
●玩家从申请列表中选择对象
●点击批准按钮
●将指定玩家的公会归属置为相应ID，官阶设为会员。

●将指定玩家的ID加入到公会成员列表，公会成员数+1
●激活指定玩家的公会面板和公会频道
●将该角色的申请请求，从申请列表中删除。

5.12.3.反对流程
●玩家从申请列表中选择对象
●点击反驳按钮
●将该角色的申请请求，从申请列表中删除。

5.13. 设置昵称
5.13.1.相关限制
●官阶必须为会长，副会长，官员
●输入内容不能为空，长度不超过12个字符
5.13.2.操作流程
●玩家从公会成员列表点选对象
●点击设置昵称按钮
●判断限制条件
●弹出输入框
●确认后将指定玩家的昵称设为输入内容
5.14. 添加敌对
5.14.1.相关限制
●操作成员官阶，必须为会长或副会长
●双方公会敌对列表必须未满
●需双方公会有权限成员（会长、副会长，任一成员确认即可），完成确认操作。

5.14.2.操作流程
●玩家在NPC处执行选项
●打开服务器公会列表
●玩家点选公会
●点击添加敌对按钮
●判断上述相关限制，若不满足，无法发送操作请求，满足则将自身公会ID添加到指定公会敌对
申请列表；
●双方公会有权限成员，执行确认操作；
●将指定公会ID加入到敌对公会字段
5.15.1.相关限制
●操作成员官阶，必须为会长或副会长
●双方公会同盟列表必须未满
●需双方公会有权限成员（会长、副会长，任一成员确认即可），完成确认操作。

5.15.2.操作流程
●玩家在NPC处执行选项
●打开服务器公会列表
●玩家点选公会
●点击邀请同盟按钮
●判断上述相关限制，若不满足，无法发送操作请求，满足则将自身公会ID添加到指定公会同盟
申请列表；
●双方公会有权限成员，执行确认操作；
●将指定公会ID加入到同盟公会字段
5.1
6. 取消敌对
5.1
6.1.相关限制
●操作成员官阶，必须为会长或副会长
5.1
6.2.操作流程
●玩家在NPC处执行选项
●打开服务器公会列表
●玩家点选公会
●点击取消敌对按钮
●将指定公会ID从敌对公会字段中删除
●将自身公会ID从指定公会敌对列表中删除
5.17.1.相关限制
●操作成员官阶，必须为会长或副会长
5.17.2.操作流程
●玩家在NPC处执行选项
●打开服务器公会列表
●玩家点选公会
●点击取消同盟按钮
●将指定公会ID从同盟公会字段删除
●将自身公会ID从指定公会的同盟列表中删除
备注：目前版本中，在公会外交关系上，仅实现添加、取消关系（同盟、敌对）的基础功能。

同盟、敌对关系，对功能带来的影响（如杀人计PK值），待后续开发。