Japanese / English
HorseRacingPlugin (Alpha)
A horse racing mini-game plugin for Minecraft (Paper 1.21).
It provides a full gameplay loop: course building, race running, betting, payouts, and scheduled races.
⚠️ This is an alpha release. Specifications, data compatibility, and balance may change frequently. Testing on a staging server is strongly recommended.
Features
- In-game course creation (checkpoint-based)
- Gate / goal line / spawn point setup
- Race operation (manual start and forced next-race start)
- Betting GUI (Win, Place, Quinella, Exacta, Trio, Trifecta)
- Vault economy integration for bet purchases and payouts
- AI profile switching and AI debug display
- Horse data management (acquire, rename, retire, records)
- Automatic race schedule generation and operation
Requirements
- Minecraft / Paper:
1.21.x(paper-api 1.21-R0.1-SNAPSHOT) - Java:
21 - Recommended dependencies:
- Vault
- An economy plugin (e.g. EssentialsX Economy)
If Vault integration is unavailable, betting features are effectively disabled (no purchases).
Installation
- Download
horseracing-0.2-SNAPSHOT.jar - Put it into your server
pluginsfolder - Start the server
- Edit
plugins/HorseRacingPlugin/config.ymlif needed - Prefer a full server restart rather than
/reload
Commands
For players
/racebet: Open the betting GUI
For admins (mainly /race)
/race create <course_name>: Enter course creation mode/race save: Save current editing data/race cancel: Cancel current setup/edit mode/race undo: Undo recent operation (course/spawn/etc.)/race list: List available courses/race setgoal <course_name>: Set goal line/race setgate <course_name>: Set gate area/race setspawn <course_name>: Set spawn points/race setwidth <course_name> <width>: Set course width/race setdirection <course_name> <clockwise|counterclockwise>: Set lap direction/race tpgate <course_name>: Teleport to gate/race cleargrass <course_name> [height_offset]: Clear grass/race clearglass <edit|apply|undo|cancel>: Edit grass-clear region/race standby <course_name> <horse_count> [track]: Prepare a race/race start <course_name>: Start race/race end <course_name>: End race/race next [start]: Show next race / force-start next race/race schedule <start|end|status>: Control schedule operation/race debug <gate|spawns|ai|off> ...: Debug display tools/race reloadai: Reload AI settings/race horse <list|info|name|retire|get>: Manage owned horses
Permissions
horseracing.race: Access to/race(default: OP)horseracing.race.admin: Administrative/raceoperations (default: OP)horseracing.bet: Access to/racebet(default: true)
About Horse AI
CPU horses in races are controlled by the plugin's AI system.
You can tune behavior in config.yml based on your server style.
race-mode: AI mode (physics/style/simple)physics: richer movement with pathing, cornering, and slope influencestyle: easier-to-read behavior based on running stylessimple: lightweight baseline behavior
ai-profile: loads AI parameter sets fromai-profiles/<name>.ymlstrategy-common: shared coefficients (pace, positioning, final spurt, stamina drain)physics-strategy: physics-only coefficients (inner-lane preference, overtaking, slope/corner effects)
AI operation tips
- Run
/race reloadaiafter tuning values - Use
/race debug ai <course_name> [horse_number]to inspect behavior - AI balance is still being tuned during alpha; adjusting values per server policy is recommended
Main config keys (config.yml)
language: display language (ja/en)debug: debug loggingrace-mode: AI mode (physics/style/simple)ai-profile: AI profile namehorse-data.limits.*: horse-data limitseconomy.enabled: enable/disable Vault integrationodds-system.*: odds and virtual bettor settingsrace-schedule.*: race interval and betting window
For schedule generation details, see generator_settings.yml.
Alpha notes
- Config keys and command behavior may change
- Internal data changes may break compatibility
- Test on smaller/staging servers first
- When reporting issues, include your
config.ymland reproduction steps
Known assumptions
- Betting requires Vault + an economy plugin
- Races may fail if course setup (gate/goal/spawns) is incomplete
Planned improvements (examples)
- Better GUI and race presentation effects
- AI and odds balance tuning
- Expanded operator/admin tooling
Feedback is welcome. Since this is an alpha release, your reports and balancing notes are highly appreciated!
/race create <コース名>: 赛道创建模式开始/race save: 保存正在创建的数据/race cancel: 取消各种设置模式/race undo: 撤销上一步操作(赛道、出生点等)/race list: 赛道列表/race setgoal <コース名>: 设置终点/race setgate <コース名>: 设置闸门/race setspawn <コース名>: 设置出生点位置/race setwidth <コース名> <幅>: 设置赛道宽度/race setdirection <コース名> <clockwise|counterclockwise>: 设置绕行方向/race tpgate <コース名>: 传送至闸门处/race cleargrass <コース名> [高さオフセット]: 清除草丛/race clearglass <edit|apply|undo|cancel>: 编辑/应用/撤销/取消清除范围/race standby <コース名> <頭数> [馬場]: 创建比赛等待状态/race start <コース名>: 开始比赛/race end <コース名>: 结束比赛/race next [start]: 显示下一场比赛信息 / 强制开始/race schedule <start|end|status>: 赛程管理/race debug <gate|spawns|ai|off> ...: 调试信息显示/race reloadai: 重新加载 AI 配置/race horse <list|info|name|retire|get>: 管理拥有的马匹
权限
horseracing.race: 使用/race的权限(默认: OP)horseracing.race.admin: 执行管理类/race操作的权限(默认: OP)horseracing.bet: 使用/racebet的权限(默认: true)
关于马匹 AI
本插件通过 AI 控制比赛中 CPU 马匹的行为。
您可以根据运营风格,在 config.yml 中更改模式或进行微调。
race-mode: 切换 AI 模式(physics/style/simple)physics: 考虑路线选择、弯道、坡道等因素,行为更加丰富style: 基于跑法逻辑,行为直观易懂simple: 轻量且易于处理的基础行为
ai-profile: 加载 AI 参数集(位于ai-profiles/<name>.yml)strategy-common: 所有模式通用的系数(巡航、占位、终局冲刺、体力消耗等)physics-strategy: 仅适用于 physics 模式的系数(偏向内栏、超车、坡道/弯道修正等)
AI 运营提示
- 若要应用调整后的设置,请执行
/race reloadai - 若要查看跑法情况,请使用
/race debug ai <course_name> [horse_number] - 由于目前处于 Alpha 阶段,AI 平衡性仍在持续调整中,建议根据服务器方针对数值进行调整
主要设置项(config.yml)
language: 显示语言(ja/en)debug: 调试日志race-mode: AI 模式(physics/style/simple)ai-profile: AI 配置文件名称horse-data.limits.*: 马匹数据上限economy.enabled: Vault 经济插件联动启用/禁用odds-system.*: 赔率计算与虚拟投注者设置race-schedule.*: 赛事间隔时间与报名时长
自动排程生成的详细设置可在 generator_settings.yml 中进行调整。
Alpha 版注意事项
- 设置键名和命令规范可能会随更新而改变
- 由于内部数据结构的变化,现有数据的兼容性可能会受损
- 建议先在小型服务器或测试环境中运行
- 报告问题时,请附上
config.yml和复现步骤
已知前提条件
- 使用投注功能需要安装 Vault 及经济类插件
- 若未完成赛道设置(闸门、终点、出生点),则无法正常举办比赛
计划更新内容(示例)
- GUI / 演出效果的增强
- 平衡性调整(AI、赔率系统)
- 扩展面向运营者的管理命令
欢迎提供反馈。由于目前处于 Alpha 版本,请务必告知您的使用体验!
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧