季节API(Seasons API)

季节API(Seasons API)

---

Github | 相关wiki | 源站链接

支持: 1.21, 1.21.1, 1.21.5,

一个用于创建自定义季节、天气和挑战的API模组，允许玩家和开发者定制游戏环境与规则。

季节API

季节API 是一个专为创建自定义季节、天气和挑战而开发的模组！

这个模组是基于Spigot插件“Seasons”的灵感，由管理员kochkaev（又名kleverdi）为其私人Minecraft服务器“Zixa City”开发的。核心创意来源于Harieo。

基本概念

• 季节：指一个虚拟年份中的特定时间段，对应当前虚拟时间的特定天气。
• 天气：游戏中的日间条件，每个天气都关联着相应的挑战。
• 挑战：一套适用于当前季节和天气的玩家规则集合。

命令语法

• /seasons get season：获取当前季节。
• /seasons get weather：获取当前天气。
• /seasons get lang：获取当前设置的语言。
• /seasons get challenges：获取活动挑战列表。
• /seasons set season <season>：设置季节。
• /seasons set weather <weather>：设置天气。
• /seasons set lang <language>：设置语言。
• /seasons set challenge [forceAllow|forceDisable] <challenge>：强制启动或结束一个挑战。
• /seasons reload：重新加载配置。
• /seasons actionbar [on|off]：为执行此命令的玩家设置是否在操作栏显示季节信息。

开发者指南

你可以在自己的模组中创建自定义的季节、天气和挑战集合。更多关于如何实现季节API的详细信息，请参考wiki。

依赖项

• Fabric API（必需）
• Text Placeholder API（可选）
• Mod Menu（可选）
• Cloth Config API（可选）
  

  截图：

  版本&下载

  所有游戏版本1.21.51.211.21.1所有类型fabric

  Seasons API 1.2-BETA-6

  下载下载

  1.2-BETA-6 · Beta版本: 1.2-BETA-6支持游戏: 1.21.5类型: FabricBeta下载次数: 571

  **Messages now use the more flexible MiniMessage for formatting** instead of the outdated color codes. [Read more about MiniMessage](https://docs.advntr.dev/minimessage/format.html).
  **Placeholder API is now a required dependency.**
  ***
  Add-on developers are now encouraged to **use Minecraft Text instead of String** for any displayed messages (_season name, weather name, chat message)_. Special `getText` and `addTextValue` methods have been added to `ConfigFileObject` and `ConfigContentObject` for this purpose.
  All **config files now have a version** _(default 1)_. Now you can easily and safely update values in configs to the new format without the user noticing, for this you need to override the `update` method in your class that extends `ConfigFileObject`.
  **MiniMessage is included to the jar!**
  ***
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.2-BETA-5...1.2-BETA-6

  展开

  Seasons API 1.2-BETA-5

  下载下载

  1.2-BETA-5 · Beta版本: 1.2-BETA-5支持游戏: 1.21.5类型: FabricBeta下载次数: 80

  Updated to Minecraft version 1.21.5.
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.2-BETA-4...1.2-BETA-5

  展开

  Seasons API 1.2-BETA-4

  下载下载

  1.2-BETA-4 · Beta版本: 1.2-BETA-4支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 1,513

  Fixed crushes when player returns to the title screen after death.
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.2-BETA-3...1.2-BETA-4

  展开

  Seasons API 1.2-BETA-3

  下载下载

  1.2-BETA-3 · Beta版本: 1.2-BETA-3支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 95

  Players can now customize for themselves whether or not to show the current season and weather information in the action bar.
  `/seasons actionbar {on/off}`
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.2-BETA-2...1.2-BETA-3

  展开

  Seasons API 1.2-BETA-2

  下载下载

  1.2-BETA-2 · Beta版本: 1.2-BETA-2支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 292

  Fixed identifier error when damage player;
  Added `addSeason(SeasonObject)` and `removeSeason(SeasonObject)` in WeatherObject;
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.2-BETA-1...1.2-BETA-2

  展开

  Seasons API 1.2-BETA-1

  下载下载

  1.2-BETA-1 · Beta版本: 1.2-BETA-1支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 85

  Added Events for mod developers
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.2-BETA-0...1.2-BETA-1

  展开

  Seasons API 1.1

  下载下载

  1.1 · Release版本: 1.1支持游戏: 1.21, 1.21.1类型: FabricRelease下载次数: 427

  **Fixed known issues**
  - Now you can skip the thunder by sleeping in a bed;
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.0...1.1

  展开

  Seasons API 1.0

  下载下载

  1.0 · Release版本: 1.0支持游戏: 1.21, 1.21.1类型: FabricRelease下载次数: 166

  Fixed some bugs.
  
  ***
  
  It was tested on Zixa City. If your found a bug, please, report it >> [Issues](https://github.com/kochkaev/seasons-api/issues)

  展开

  Seasons API 1.0-RC-5

  下载下载

  1.0-RC-5 · Beta版本: 1.0-RC-5支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 1,127

  # Seasons now can cycle!
  ## Seasons changes
  All seasons are now stored in a `Tree` structure consisting of a `TreeBranch`. Each branch can have many branches but only one parent, can store only one `SeasonObject`, but one season can be stored in several branches at once and have many parents. Seasons that have no parents (located at the root of the tree) are called highest (first) order seasons. The longer the “path” to a season - the lower its order.
  <details><summary><a>Seasons tree example</a></summary>
  <img src="https://github.com/user-attachments/assets/27941ae6-50d9-488a-b26f-66c6b382333a" alt="Tree">
  </details>
  A season can store a list of seasons after which it will occur with a specified chance (if there are other seasons that occur after the same season). If at the end of a season it turns out that no season comes after it, a random season is set (given its chance of being set; a chance of 0 means that the season cannot be set automatically).
  
  ## Configs changes
  The config system was completely rewritten and optimized. Now all config files are described in `ConfigFileObject` and their contents are stored in `ConfigContentObject`. All values in configs are now automatically typed depending on the default value. Added methods to create a selection from some list. All values are now stored in `ConfigValueObject` (or `ConfigSelectionObject` if it is a list).
  ### Methods
  - `addHeader` - add header.
  - `addValue` - add parameter.
  - `addDynamicSelectionButton` - add a selection from a list (as a button in the interface) obtained from the supplier.
  - `addStaticSelectionButton` - add a selection from the list (as a button in the interface) passed in the method call.
  - `addDynamicSelectionDropdown` - add a selection from the list (as a dropdown list in the interface) received from the suppler.
  - `addStaticSelectionDropdown` - add a selection from the list (as a dropdown list in the interface) passed in the method call.
  - `addDynamicSelectionSuggestion` - add a selection from the list (as a prompt when entering text in the interface), received from the suppler.
  - `addStaticSelectionSuggestion` - add a selection from the list (in the form of prompts when entering text in the interface), passed when calling the method.
  ### Parameters
  - _key_ - key, used to get the value.
  - _value_ - default value, further typing of the changed value depends on the type of this value.
  - _header_ - header (mostly decoration), specify “” if you want to inherit it from the previous added value or header.
  - _description_ - description of the parameter.
  - _consumer_ - lambda expression executed when the value is changed, receiving the old and new value as input.
  - _list_ - list containing possible values for the parameter.
  - _supplier_ - lambda expression that returns the list.
  
  ## Challenges Ticker
  The `ChallengesTicker` now ticks not every secondsPerTick seconds, but every ticksPerChallengeTick Minecraft ticks (1 second = 20 Minecraft ticks)
  
  ***
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.0-RC-4.3...1.0-RC-5

  展开

  Seasons API 1.0-RC-4.3

  下载下载

  1.0-RC-4.3 · Beta版本: 1.0-RC-4.3支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 194

  Update ModMenu integration
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.0-RC-4.2...1.0-RC-4.3

  展开

  Seasons API 1.0-RC-4.2

  下载下载

  1.0-RC-4.2 · Beta版本: 1.0-RC-4.2支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 106

  Fixed config update using Cloth Config.
  Optimized TXTConfigObject and ClothConfigClient

  展开

  Seasons API 1.0-RC-4.1

  下载下载

  1.0-RC-4.1 · Beta版本: 1.0-RC-4.1支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 71

  Fixed server crashes.
  Added new config features.

  展开

  Seasons API 1.0-RC-4

  下载下载

  1.0-RC-4 · Alpha版本: 1.0-RC-4支持游戏: 1.21, 1.21.1类型: FabricAlpha下载次数: 113

  ### Added client-side supporting!
  Added Cloth Config and Mod Menu client integration.
  `current.json` moved to world directory as `seasons-current.json`
  Added auto creating GUI for all config files (except langs).
  
  ### Added new features to config generation:
  - `addHeader(String header)` - add header to file _("# * Header")_ and Cloth Config entries.
  - `addTypedValue(String key, Object value)` - add auto parsing value _(required to correct entry creating in Cloth Config; in following format: 'key: "value" # | type: "Type"')_
  - `addTypedValueAndCommentDefault(String key, Object value)` - add auto parsing value and comment with default value _(in Cloth Config works similarly to `addTypedValue(String key, Object value)`; in following format: 'key: "value" # | type: "Type" | default: "value"')_
  
  **Full Changelog**: https://github.com/kochkaev/seasons-api/compare/1.0-RC-3.3...1.0-RC-4

  展开

  Seasons API 1.0-RC-3.3

  下载下载

  1.0-RC-3.3 · Beta版本: 1.0-RC-3.3支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 86

  Fixes execution of new logic in tasks

  展开

  Seasons API 1.0-RC-3.2

  下载下载

  1.0-RC-3.2 · Alpha版本: 1.0-RC-3.2支持游戏: 1.21, 1.21.1类型: FabricAlpha下载次数: 88

  Adds getTaskKey(ServerPlayerEntity player, String taskName) in ChallengeObject to quick get unique key for task.

  展开

  Seasons API 1.0-RC-3.1

  下载下载

  1.0-RC-3.1 · Alpha版本: 1.0-RC-3.1支持游戏: 1.21, 1.21.1类型: FabricAlpha下载次数: 101

  Update Tasks and Frozen effect
  Now key can be any Object, lambda expression and list of args for them is now saving to new Map1Key2Values collector.
  Frozen is now automaticly gives and removes for particular player (when you calls some protected methods in ChallengeObject)

  展开

  Seasons API 1.0-RC-2

  下载下载

  1.0-RC-2 · Beta版本: 1.0-RC-2支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 136

  Split Config.java to Config service and ConfigObject.
  Add getFloat(String) and getDouble(String) to TXTConfigObject

  展开

  Seasons API 1.0-RC

  下载下载

  1.0-RC · Beta版本: 1.0-RC支持游戏: 1.21, 1.21.1类型: FabricBeta下载次数: 77

  展开

  全部版本