Re:AcademyCraft

English

Re:AcademyCraft 1.4.0 — Minecraft 1.20.1 / Forge

This update adds an Ability Settings app for configuring abilities through an in-game screen, along with an experimental public API for add-ons.

The existing gameplay balance of the 4 built-in ability categories and 41 skills is preserved, while add-ons can introduce new categories and skills and integrate them with equipment and machines. New abilities and skills require a compatible add-on.

Requirements: Minecraft 1.20.1, Forge 47.4.10 or later (below 48), and Java 17. Install the mod on both the client and server.

Before updating

• Back up your worlds and configuration files. Loading worlds from 1.3.0 is supported. However, downgrading a world after opening it in 1.4.0 is not guaranteed.
• Update the server and all clients to 1.4.0. The network protocol has changed, so 1.3.0 and 1.4.0 cannot connect to each other.
• Your Electron Missile and Light Shield settings from 1.3.0 are retained.
• When using add-ons, install the same add-ons and versions on the server and all clients. If registered ability categories or skills do not match, the connection is refused and the affected IDs are displayed.

Ability Settings app

A new preinstalled app, Ability Settings, is now available in the Data Terminal. You can also assign a key to “Open Ability Settings” in Controls. It is unbound by default.

The screen provides the following settings:

• Electron Missile: Aiming mode (AUTO / SEMI-AUTO) and attack targets (hostile / neutral / friendly / players)
• Light Shield: Operating mode (AUTO / SEMI-AUTO)

These are the same settings used by /academy missile and /academy shield. Both commands remain available, and operator permission is not required.

Settings are saved on the server. You can configure skills before learning them; the settings take effect once those skills become available. Opening this screen does not interrupt toggle abilities such as Light Shield.

Add-on support — experimental

Adding ability categories and skills

• Add-ons can introduce new ability categories and skills, or add skills to existing categories such as Electromaster.
• Added skills can be learned through the Ability Developer’s skill tree, placed in presets, and activated with skill keys.
• Each add-on has its own configuration file for skill availability, damage multipliers, CP consumption, overload, proficiency, and block breaking.
  • Location: config/academy-addon-<namespace>.toml
• Removing an add-on leaves its category, skill, and preset-slot records dormant. Reinstalling the corresponding add-on restores them. Missing categories are shown as “Not installed” in the Ability Developer.

Activating skills through equipment, machines, and non-player actors

A new API allows add-on skills to be activated through equipment, machines, and add-on-controlled characters, in addition to normal skill-key controls.

The add-on must implement the corresponding activation logic. The 41 built-in skills are not available through this external activation API.

Actions routed through the provided safety API are subject to the following restrictions:

• Attacking players or modifying terrain requires an accountable player who is currently logged in. Applicable PvP, team, building-permission, and other checks are performed for that player.
• Terrain changes made by machines or AI-controlled actors also require permission from the mobGriefing game rule.

The external activation API also refuses new activations and stops ongoing ones when the activation source is within an Ability Interferer’s range.

Ability visuals for add-ons

A new API lets add-ons use the mod’s ability visuals. As its first supported effect, the Meltdowner beam is available on an experimental basis.

• Only the Meltdowner beam visual is currently supported. Support for other ability visuals is planned, but the scope and timing have not yet been determined.
• This is a rendering-only feature. It does not include damage, hit detection, or sound effects.
• Beams can be up to 96 blocks long. The default simultaneous limit is 32 beams per add-on on each client. This limit can be changed in the client settings.
• Add-on visuals use a separate allowance and do not consume the slots used by the built-in abilities’ beams and orbs.

Other improvements

• Player data containing an unreadable ability category ID is now preserved as read-only instead of being deleted.

For add-on developers

The SDK is available free of charge on GitHub Releases.

It includes the API JAR, API sources, Javadoc, a sample add-on, a developer guide in Japanese, and a hash list. This CurseForge file contains only the Re:AcademyCraft mod.

The SDK uses GPLv3, the same license as the mod. Do not bundle the API classes in your add-on; Re:AcademyCraft must be installed at runtime.

Known limitations

• The public API is experimental. API names and specifications may change in future versions.
• Safety checks apply only to actions routed through the provided safety API. The mod does not universally restrict add-ons that modify the world directly.
• Add-on beam visuals have not been tested with shader packs or other rendering mods.

For more information and bug reports, visit GitHub Issues.

日本語

Re:AcademyCraft 1.4.0 — Minecraft 1.20.1 / Forge

能力の設定を画面から変更できる「能力設定」アプリと、アドオン向けの公開API（実験的）を追加しました。

既存の4系統・41技能のゲームバランスを維持しながら、アドオンによる能力・技能の追加や、装備・機械との連携に対応します。新しい能力や技能を利用するには、別途対応アドオンが必要です。

動作要件： Minecraft 1.20.1、Forge 47.4.10以上・48未満、Java 17。クライアントとサーバーの両方に導入してください。

更新前の注意

• ワールドと設定をバックアップしてください。 1.3.0のワールドの読み込みに対応しています。ただし、1.4.0で開いたワールドを旧版へ戻せることは保証しません。
• サーバーと全クライアントを1.4.0に統一してください。 通信プロトコルを変更したため、1.3.0と1.4.0の間では接続できません。
• 1.3.0で設定したエレクトロン・ミサイルとライト・シールドの設定は引き継がれます。
• アドオンを使用する場合は、サーバーと全クライアントに同じアドオン・同じバージョンを導入してください。登録された能力や技能が一致しない場合は、該当するIDを表示して接続を拒否します。

能力設定アプリ

データ端末に、プリインストールアプリ「能力設定」を追加しました。操作設定の「能力設定を開く」にキーを割り当てて開くこともできます。初期状態では未割り当てです。

画面から変更できる項目は次のとおりです。

• エレクトロン・ミサイル： 照準モード（AUTO／SEMI-AUTO）と攻撃対象（敵対・中立・友好・プレイヤー）
• ライト・シールド： 動作モード（AUTO／SEMI-AUTO）

/academy missile・/academy shieldと共通の設定で、コマンドも引き続き使用できます。OP権限は不要です。

設定はサーバーに保存されます。未習得の技能も事前に設定でき、使用可能になった時点で反映されます。この画面を開いても、ライト・シールドなどの切り替え型能力は中断されません。

アドオン対応〈実験的〉

能力・技能の追加

• 新しい能力系統や技能を追加できます。既存の系統（電撃使いなど）へ技能を追加することもできます。
• 追加された技能は、能力開発機の技能ツリーで習得し、プリセットに配置して技能キーで使用できます。
• アドオンごとの設定ファイルで、技能の有効・無効、ダメージ倍率、CP消費・過負荷、熟練度、ブロック破壊に関する設定を調整できます。
  • 保存先：config/academy-addon-<名前空間>.toml
• アドオンを外しても、対応する能力系統・技能・プリセット枠の記録は休眠状態で保持され、対応するアドオンを再導入すると復帰します。未導入の系統は、能力開発機に「未導入の系統」と表示されます。

装備・機械・プレイヤー以外からの能力発動

アドオンで追加した技能を、通常の技能キー操作に加えて、装備や機械、アドオンが制御するキャラクターなどから発動できるAPIを追加しました。

対応する発動処理はアドオン側で実装する必要があります。本体の既存41技能は、この外部発動APIの対象外です。

提供する安全判定APIを通した処理には、次の制限が適用されます。

• プレイヤーへの攻撃や地形変更には、ログイン中の責任者となるプレイヤーが必要です。そのプレイヤーに適用されるPvP・チーム・建築権限などの判定を行います。
• 機械やAI制御の発動元による地形変更には、ゲームルールmobGriefingの許可も必要です。

また、外部発動APIでは、発動元が能力干渉器の範囲内にある場合、新しい発動を拒否し、継続中の発動を停止します。

アドオン向けの能力演出

アドオンから本体の能力演出を利用するためのAPIを追加しました。最初の対応として、メルトダウナーの光線演出を試験的に利用できます。

• 現時点で対応しているのは、メルトダウナーの光線演出のみです。ほかの能力演出にも今後対応していく予定ですが、対応内容・時期は未定です。
• 描画専用の機能で、ダメージ・命中判定・効果音は含みません。
• 光線の長さは最大96ブロック。同時表示数は、各クライアントでアドオンごとに既定32本です。表示上限はクライアント設定で変更できます。
• 表示枠は本体の能力演出と分かれており、本体の光線・球の表示枠を消費しません。

その他の改善

• 読み取れない能力系統IDを含むプレイヤーデータを、削除せず読み取り専用で保持するようにしました。

アドオン開発者の方へ

SDKをGitHub Releasesで無料配布しています。

SDKには、API JAR、APIソース、Javadoc、サンプルアドオン、日本語の開発者ガイド、ハッシュ一覧を含みます。このCurseForgeファイルに含まれるのは、Re:AcademyCraft本体のみです。

SDKのライセンスは、本体と同じGPLv3です。APIクラスをアドオンへ同梱せず、実行時にはRe:AcademyCraft本体を導入してください。

既知の制約

• 公開APIは実験的な機能です。 今後のバージョンで、APIの名称や仕様が変更される場合があります。
• 安全判定の対象は、提供する安全判定APIを通した処理のみです。アドオンがワールドを直接変更する処理を、本体が一律に制限するものではありません。
• アドオン向け光線演出と、シェーダーパック・他の描画変更Modとの組み合わせは未検証です。

詳細・不具合報告はGitHub Issuesをご覧ください。

简体中文

Re:AcademyCraft 1.4.0 — Minecraft 1.20.1 / Forge

本次更新新增了可通过游戏内界面调整能力设置的“能力设置”应用，以及面向附属Mod的公开API（实验性）。

在保持现有4个能力系、41个技能的游戏平衡不变的基础上，支持附属Mod添加新的能力系与技能，并与装备、机器联动。使用新增能力或技能需要另行安装兼容的附属Mod。

运行要求： Minecraft 1.20.1、Forge 47.4.10及以上（低于48）、Java 17。客户端与服务器均须安装本Mod。

更新前请注意

• 请备份世界存档与配置文件。 支持读取1.3.0的世界存档，但不保证在1.4.0中打开过的存档能够安全降级。
• 请将服务器和所有客户端统一更新至1.4.0。 网络协议已变更，1.3.0与1.4.0无法互相连接。
• 1.3.0中保存的巡航光束炮与光盾设置会保留。
• 使用附属Mod时，请在服务器和所有客户端安装相同的附属Mod及版本。如果注册的能力系或技能不一致，将显示相关ID并拒绝连接。

能力设置应用

数据终端新增了预装应用“能力设置”。也可以在按键设置中为“打开能力设置”分配按键；默认未绑定。

可在界面中调整以下项目：

• 巡航光束炮： 瞄准模式（AUTO／SEMI-AUTO）与攻击目标（敌对／中立／友好／玩家）
• 光盾： 运行模式（AUTO／SEMI-AUTO）

这些选项与/academy missile、/academy shield使用同一组设置。两个命令仍可继续使用，且无需管理员（OP）权限。

设置保存在服务器上。尚未习得的技能也可以提前设置，并在技能可用时生效。打开此界面不会中断光盾等开关型能力。

附属Mod支持〈实验性〉

添加能力系与技能

• 附属Mod可以添加新的能力系与技能，也可以向现有能力系（例如电击使）添加技能。
• 新增技能可以通过能力开发机的技能树习得，放入预设，并使用技能键发动。
• 每个附属Mod都有独立的配置文件，可调整技能启用状态、伤害倍率、CP消耗、过载、熟练度及方块破坏相关设置。
  • 路径：config/academy-addon-<命名空间>.toml
• 移除附属Mod后，对应的能力系、技能及预设栏位记录会以休眠状态保留，重新安装对应的附属Mod后即可恢复。缺失的能力系会在能力开发机中显示为“未安装的能力系”。

通过装备、机器及非玩家主体发动技能

新增的API允许附属Mod技能通过装备、机器或由附属Mod控制的角色等主体发动，不再局限于通常的技能键操作。

对应的发动逻辑需要由附属Mod实现。本体的现有41个技能不属于此外部发动API的支持范围。

通过所提供的安全判定API执行的操作，受到以下限制：

• 攻击玩家或改变地形时，必须关联一名当前在线、负责该操作的玩家。系统会检查适用于该玩家的PvP、队伍、建造权限等规则。
• 机器或AI控制的主体改变地形时，还需要游戏规则mobGriefing允许。

此外，当发动源位于能力干扰器的范围内时，外部发动API会拒绝新的发动，并停止正在持续的发动。

供附属Mod使用的能力特效

新增了供附属Mod调用本体能力特效的API。作为首个支持的特效，现已实验性支持粒机波形炮的光束特效。

• 目前仅支持粒机波形炮的光束特效。计划在未来支持其他能力特效，具体内容与时间尚未确定。
• 此功能仅负责渲染，不包含伤害、命中判定或音效。
• 光束最长96格。默认同时显示上限为每个客户端、每个附属Mod各32条，可在客户端设置中调整。
• 附属Mod特效使用独立的显示额度，不占用本体能力光束与光球的显示名额。

其他改进

• 对于包含无法读取的能力系ID的玩家数据，现在会以只读方式保留，而不会删除。

致附属Mod开发者

SDK在GitHub Releases免费提供。

SDK包含API JAR、API源码、Javadoc、示例附属Mod、日文开发者指南及哈希列表。此CurseForge文件仅包含Re:AcademyCraft本体。

SDK与本体一样采用GPLv3许可。请勿将API类打包进附属Mod；运行时需要安装Re:AcademyCraft本体。

已知限制

• 公开API为实验性功能。 后续版本可能更改API名称或规范。
• 安全判定仅适用于通过所提供的安全判定API执行的操作。本体不会统一限制附属Mod直接修改世界的行为。
• 附属Mod光束特效与光影包或其他渲染修改Mod的兼容性尚未经过测试。

更多信息及问题反馈请访问GitHub Issues。