MCkeiba

插件

· 作者 tatukigenki

alpha 中的房屋竞速与投注系统

0 本站下载 0 关注 更新于 8 个月前

最新 alpha1 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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

  1. Download horseracing-0.2-SNAPSHOT.jar
  2. Put it into your server plugins folder
  3. Start the server
  4. Edit plugins/HorseRacingPlugin/config.yml if needed
  5. 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 /race operations (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 influence
    • style: easier-to-read behavior based on running styles
    • simple: lightweight baseline behavior
  • ai-profile: loads AI parameter sets from ai-profiles/<name>.yml
  • strategy-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 reloadai after 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 logging
  • race-mode: AI mode (physics / style / simple)
  • ai-profile: AI profile name
  • horse-data.limits.*: horse-data limits
  • economy.enabled: enable/disable Vault integration
  • odds-system.*: odds and virtual bettor settings
  • race-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.yml and 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 版本,请务必告知您的使用体验!

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源