StellarGyms

星辰道馆

星辰道馆是一个服务器权威的宝可梦道馆系统，玩家在其中竞争成为由AI控制的持久化道馆的冠名馆主。

当挑战者击败道馆时，他们进入时所使用的队伍会被完整保留，并成为道馆的下一支防守队伍。未来的挑战者将与这支队伍的AI控制副本战斗，而获胜的玩家则显示为当前的馆主。

被捕获的队伍会保留其重要的宝可梦数据，包括种族、形态、配色、闪光状态、等级、个体值、努力值、性格、特性、招式、PP值、携带物品、缎带、亲密度、精灵球、极巨化和超极巨化数据，以及其他持久化的宝可梦属性。

功能特点

• 持久化的玩家控制道馆继承机制
• 获胜队伍的AI控制副本
• 可配置的初始道馆队伍
• 馆主、挑战者、宿敌关系及接管历史
• 排行榜和玩家档案
• 当前及最佳连胜纪录
• 防守连胜纪录和里程碑奖励
• 完美胜利追踪
• 特色道馆轮换
• 每日多道馆巡回赛
• 永久徽章陈列柜进度
• 可选实体徽章奖励
• 道馆悬赏金，随符合条件的挑战者败北而增长
• 离线奖励发放和持久化通知
• 每个道馆可配置的NPC
• 经济、物品、命令、经验、消息和广播奖励
• 原版箱子菜单后备方案
• 可选的动画客户端界面
• 审计日志和持久化服务器数据
• Brigadier命令建议
• NeoForge权限支持

道馆继承机制

每个道馆初始由管理员定义队伍。

当玩家击败初始队伍时：

 

• 该玩家成为冠名馆主。
• 他们进入时所使用的队伍成为新的防守队伍。
• 将获得配置的初始胜利奖励。

当另一位玩家击败由玩家衍生的队伍时：

• 挑战者获得配置的征服奖励。
• 任何累积的道馆悬赏金也会包含在内。
• 挑战者成为新的冠名馆主。
• 他们进入的队伍替换之前的防守队伍。

最初的由管理员定义的队伍仍保留，作为道馆的重置基准线。

运行时的防守宝可梦在战斗前会被复制并治疗。它们会获得临时的内部UUID，因此不会与馆主实际拥有的宝可梦冲突。

悬赏金与反刷机制

当挑战者输给玩家控制的道馆时，该道馆可以累积悬赏金。

同一挑战者重复失败，只有在配置的冷却时间到期后才会增加悬赏金。这可以防止玩家故意反复输掉比赛以膨胀道馆奖励。

初始管理员队伍不会累积悬赏金。

进度系统

特色道馆

每轮轮换会选择一个符合条件的道馆作为特色道馆。

玩家在该轮轮换期间首次击败特色道馆时，将获得配置的特色奖励。轮换状态会被持久化存储，无法通过重新连接来重新随机。

每日巡回赛

玩家可以通过击败配置数量的不同可用道馆来完成每日巡回赛。

巡回赛进度：

• 仅在击败不同道馆时推进
• 每完成一轮巡回赛奖励玩家一次
• 在UTC午夜自动重置
• 在服务器重启后保持

徽章陈列柜

玩家首次通关每个道馆后，该道馆会永久性加入他们的徽章收藏。

服务器可以选择性地在持久徽章条目之外发放实体徽章物品。

玩家统计

星辰道馆追踪以下数据：

• 道馆胜利
• 防守胜利
• 当前挑战者连胜
• 最佳挑战者连胜
• 当前防守连胜
• 最佳防守连胜
• 完美胜利
• 特色道馆胜利
• 针对特定道馆的宿敌统计
• 徽章所有权
• 近期公开对战活动
• 排行榜得分与排名

奖励系统

每个道馆可以为以下不同情况定义独立的奖励包：

• 初始队伍胜利
• 玩家队伍征服
• 防守里程碑
• 特色道馆胜利
• 每日巡回赛完成
• 首次徽章通关

奖励包可以包含：

• 宝可梦币或Vault货币
• 玩家经验
• Minecraft或模组物品注册表ID
• 控制台命令
• 私聊消息
• 服务器广播

奖励命令支持以下占位符：

• {player}
• {uuid}
• {gym}
• {leader}

离线接管和防守奖励会一直存储，直到玩家登录或使用 /sg claim 领取。

经济支持

经济模式可以配置为：

• AUTO
• PIXELMON
• VAULT
• NONE

AUTO

首先尝试使用宝可梦内置的银行系统，然后检查是否有兼容的Vault经济提供者。

PIXELMON

使用宝可梦币。

VAULT

在兼容的混合NeoForge/Bukkit服务器上使用已注册的Vault经济提供者。

NONE

禁用货币存款，同时允许非货币奖励，如物品、经验、命令和消息。

服务器可以配置当经济系统不可用时，是导致整个奖励包失败还是仅跳过货币部分。

可选客户端界面

服务器模组包含所有游戏玩法，不需要玩家安装客户端配套模组。

没有安装客户端模组的玩家仍可通过以下方式访问：

• 命令
• 道馆NPC
• 原版分页箱子菜单

可选的客户端配套模组增加了：

• 中央道馆导航枢纽
• 动画道馆档案
• 实时排行榜
• 玩家档案
• 奖励领取
• 收藏夹和筛选器
• 滚动页面
• 动画过渡效果
• 十八种宝可梦属性主题
• 十种道馆边框主题
• 四种中央菜单世界
• 客户端声音控制
• 减少动态效果的辅助功能设置

服务器控制活动的界面主题。玩家只能更改自己的本地声音和减少动态效果的偏好。

主菜单主题

中央菜单支持四种由服务器选择的世界：

• cosmic_forge
• chrono_garden
• quantum_koi
• aurora_engine

玩家无法覆盖服务器选择的中央菜单主题。

道馆属性类型

每个道馆可以使用宝可梦的十八种标准属性之一：

• 一般
• 火
• 水
• 电
• 草
• 冰
• 格斗
• 毒
• 地面
• 飞行
• 超能力
• 虫
• 岩石
• 幽灵
• 龙
• 恶
• 钢
• 妖精

auto 选项会根据道馆配置的要求，或尽可能根据名称和ID来选择属性类型。

道馆边框主题

每个道馆可以使用十种视觉边框样式之一：

• astral_observatory
• glass_menagerie
• neon_metro
• clockwork_vault
• verdant_conservatory
• abyssal_sonar
• royal_tactics
• arcade_gauntlet
• weather_beacon
• lunar_archive

配置

每个道馆都有自己的JSON配置文件。

管理员可以配置：

• 道馆ID和显示名称
• 启用状态
• 初始防守队伍
• 战斗规则
• 访问限制
• 所需宝可梦属性
• 道馆属性类型
• 视觉边框主题
• 主菜单主题
• NPC名称
• NPC皮肤
• NPC位置
• 挑战可用性
• 初始胜利奖励
• 征服奖励
• 悬赏金增长
• 重复失败奖励冷却时间
• 防守里程碑要求
• 特色道馆奖励
• 巡回赛奖励
• 徽章奖励
• 经济行为
• 实体徽章物品
• 消息和广播
• 命令奖励
• 经验奖励
• 物品奖励
• 权限要求
• 客户端声音
• 客户端动态设置
• 排行榜计分
• 操作员权限等级

生成的示例道馆默认是禁用的，因此新服务器不会意外发布一个占位队伍或分发非预期的奖励。

玩家命令

/sg

打开可用的最佳道馆界面。

别名：

• /gyms
• /stellargyms

/sg challenge <gym>

在道馆的访问规则允许时挑战该道馆。

/sg info <gym>

显示道馆当前的馆主、防守队伍、连胜纪录、悬赏金和历史记录。

/sg list

列出已配置的道馆。

/sg top

显示服务器权威的玩家排行榜。

排行榜计分可以包括：

• 胜利次数
• 防守胜利
• 挑战者连胜
• 防守连胜
• 完美胜利
• 特色胜利

/sg profile

显示玩家私人的道馆统计、得分、排名、连胜纪录和徽章持有情况。

/sg featured

显示当前特色道馆和剩余轮换时间。

/sg circuit

显示玩家当前的每日巡回赛进度。

/sg inbox

显示持久化的道馆通知，包括馆主被替换和防守里程碑。

/sg inbox clear

清除存储的道馆通知。

/sg claim

领取排队的接管和防守奖励。

/sg help

显示命令帮助。

管理员命令

/sg admin create <id> <name>

创建一个新的道馆，并尝试将命令发送者当前符合条件的宝可梦队伍捕获为其初始队伍。

/sg admin setteam <gym> [player]

使用所选玩家的队伍替换道馆的永久初始队伍。

/sg admin setleader <gym> <player>

强制设置一个由玩家衍生的防守队伍，而不替换道馆存储的重置基准线。

/sg admin setnpc <gym>

将道馆配置的NPC放置或移动到管理员当前的位置。

/sg admin spawnnpc <gym>

生成道馆NPC。

/sg admin removenpc <gym>

移除道馆NPC。

/sg admin settheme <gym> <theme>

更改道馆的视觉边框主题。

/sg admin setmenutheme <theme>

更改服务器范围的中央菜单主题。

/sg admin settype <gym> <auto|type>

设置道馆的动画宝可梦属性标识。

/sg admin setreward <gym> ...

更改已配置的道馆奖励。

/sg admin toggle <gym>

启用或禁用某个道馆。

/sg admin reset <gym> confirm

恢复道馆最初由管理员定义的队伍。

/sg admin status

显示道馆系统和配置状态。

/sg admin reload

重新加载星辰道馆的配置文件。

命令建议会自动包含已配置的道馆ID、宝可梦属性、视觉主题、奖励类型和支持的标志。

权限

玩家操作默认是允许的，除非通过兼容的NeoForge权限提供者进行更改。

玩家权限

• stellar_gyms.stellargyms.open
• stellar_gyms.stellargyms.challenge
• stellar_gyms.stellargyms.info
• stellar_gyms.stellargyms.top
• stellar_gyms.stellargyms.claim
• stellar_gyms.stellargyms.chest
• stellar_gyms.stellargyms.client

管理员权限

• stellar_gyms.stellargyms.admin
• stellar_gyms.stellargyms.reload
• stellar_gyms.stellargyms.create
• stellar_gyms.stellargyms.npc
• stellar_gyms.stellargyms.reset
• stellar_gyms.stellargyms.reward

管理员权限默认为配置的操作员等级。

兼容的权限插件可能会显示较短的逻辑权限名称，如 stellargyms.<action>。

通知与领取

星辰道馆为重要的道馆事件维护一个持久化的收件箱。

玩家可以在以下情况收到通知：

• 他们作为道馆馆主被替换时
• 他们获得防守里程碑时
• 离线奖励被排队时
• 接管影响到他们的某个道馆时

通知和奖励在服务器重启后仍然可用。

服务器权威设计

所有战斗、道馆队伍、奖励、进度、排名和权限都由服务器控制。

可选的客户端界面只显示服务器提供的信息，并将请求的操作发送回服务器。安装客户端配套模组并不会让玩家控制道馆数据、奖励、队伍或主题。