原创 【XMSwampDivineTree·沼泽神树】 1.0.3

1. 查询玩家贡献度​

方法名: API_GetPlayerContribution
参数:

• string userID - 玩家的SteamID（字符串格式）

返回值:

• int - 玩家的总贡献度
• 如果玩家不存在或userID无效，返回 0

2. 增加玩家贡献度​

方法名: API_AddPlayerContribution
参数:

• string userID - 玩家的SteamID（字符串格式）
• int points - 要增加的贡献度数量（必须大于0）

返回值: 无

3. 扣除玩家贡献度​

方法名: API_RemovePlayerContribution
参数:

• string userID - 玩家的SteamID（字符串格式）
• int points - 要扣除的贡献度数量（必须大于0）

返回值: 无

4. 查询神树等级​

方法名: API_GetTreeLevel
参数: 无
返回值:

• int - 当前神树等级

5. 显示主界面​

方法名: API_ShowMainUI
功能: 为指定玩家显示神树主界面UI
参数:

• BasePlayer player - 要显示UI的玩家对象

返回值: 无

Hooks​

1. 玩家增加贡献度时​

Hook名称: OnSwampTreeContributionAdd
触发时机: 当玩家通过任何方式增加贡献度时（包括API调用、UI贡献、丢弃贡献等）
参数:

• BasePlayer player - 增加贡献度的玩家对象
• int addedPoints - 本次增加的贡献度数量
• int totalPoints - 增加后玩家的总贡献度

返回值: 无需返回值

2. 玩家扣除贡献度时​

Hook名称: OnSwampTreeContributionRemove
触发时机: 当玩家通过任何方式扣除贡献度时（包括API调用、兑换物品等）
参数:

• BasePlayer player - 扣除贡献度的玩家对象
• int removedPoints - 本次扣除的贡献度数量
• int totalPoints - 扣除后玩家的总贡献度

返回值: 无需返回值

3. 神树等级提升时​

Hook名称: OnSwampTreeLevelUp
触发时机: 当神树等级提升时（任何玩家贡献导致总贡献度达到升级要求）
参数:

• int oldLevel - 提升前的神树等级
• int newLevel - 提升后的神树等级

返回值: 无需返回值

4. 神树等级降级时​

Hook名称: OnSwampTreeLevelDown
触发时机: 当神树等级降低时（玩家兑换物品导致总贡献度下降到降级阈值）
参数:

• int oldLevel - 降级前的神树等级
• int newLevel - 降级后的神树等级

返回值: 无需返回值