开发者文档

API

职业模块所对外暴露的所有API

    /**
     * 根据职业ID获取职业对象
     * @param roleId 职业ID
     * @return 查无结果返回null
     */
    IRole getById(String roleId);

    /**
     * 获取所有职业
     * @return 职业列表
     */
    List<IRole> getAll();

    /**
     * 根据玩家ID获取玩家当前的职业数据对象
     * @param uuid 玩家UUID字符串
     * @return 查无结果返回null
     */
    IRole getRole(String uuid);

    /**
     * 将指定玩家转职成为指定职业
     * 会进行筛选当前玩家的转职条件是否满足
     * @param uuid 玩家UUID字符串
     * @param roleId 职业ID
     * @throws ServiceErrorSendMsgException 抛出由玩家原因的操作错误,该异常信息应该向玩家进行消息发送
     */
    void upRole(String uuid , String roleId) throws ServiceErrorSendMsgException;

    /**
     * 将指定玩家设置为默认职业
     * @param uuid 玩家UUID字符串
     * @throws ServiceErrorSendMsgException 抛出由玩家原因的操作错误,该异常信息应该向玩家进行消息发送
     */
    void setPlayerDefRole(String uuid) throws ServiceErrorSendMsgException;

    /**
     * 根据玩家ID查询当前玩家能够转职的所有职业
     * @param uuid 玩家ID
     * @return 职业列表
     */
    List<IRole> getListByPlayerId(String uuid);

    /**
     * 检测当前职业是否可用
     * @param role 职业对象
     * @return 可用返回true
     */
    boolean isPerfect(IRole role);

    /**
     * 获取这位玩家当前的攻击算法
     * @param p 玩家
     * @return 如果没有找到相应算法，返回Null
     */
    IPlayerAlgorithm getDamageAlgorithmByPlayer(Player p);

    /**
     * 获取这为玩家当前的防御算法
     * @param p 玩家
     * @return 如果没有找到相应算法，返回Null
     */
    String getDefenseAlgorithmByPlayer(Player p);

事件

类名	说明
SetDefRoleEvent	被设置为默认职业事件
UpRoleEvent	转职成功事件