OxCoinFlip
OxCoinFlip 是一款面向 Paper 服务器的现代化、基于图形用户界面(GUI)的掷硬币赌博插件,支持 Vault 经济系统。
创建赌注,选择正面或反面,并邀请其他玩家发起挑战。结果是一个公平的 50/50 掷硬币过程,胜者将获得扣除可选税费后的合并彩池。
核心功能
OxCoinFlip 提供完整且安全的下注框架,包含交互式动画和全面自定义选项:
- 公平的 50/50 结果: 结果完全随机,正面或反面的概率均为 50%。
- Vault 经济集成: 完全兼容 Vault 以及 EssentialsX 等经济插件提供商。
- 交互式 GUI 与大厅: 活跃的下注会显示在全局大厅中,比赛开始时会出现带有动画效果的掷硬币屏幕。
- 下注规则与限制: 下注创建者选择正面或反面;挑战者自动获得相反的一面。每位玩家最多可持有 3 个活跃下注,默认最大下注金额为 100,000,000。
- 防作弊与菜单安全: 完全防止物品移动、拖拽、Shift+点击、快捷栏交换以及重复接受下注。玩家无法接受自己的下注。
- 自动化彩池与税费: 即时、安全的余额检查;胜者获得合并彩池减去可配置的税费。当下注被移除时,将立即退还赌注金额。
- MiniMessage 格式支持: 完全支持 MiniMessage 格式、自定义音效以及可配置的 GUI 图标。
玩法与管理命令
OxCoinFlip 提供了直观的玩家命令,用于创建、管理和查看活跃下注。
玩家命令
/cf — 打开当前活跃的掷硬币大厅 GUI(别名:/coinflip)。
/cf create <heads|tails> <amount> — 创建一个新的掷硬币下注(例如,/cf create heads 1000)。
/cf remove <number> — 移除其中一个你的活跃下注,并立即退还下注金额。
工作原理
- 创建: 运行
/cf create <heads|tails> <amount>。你的余额会被立即扣除,该下注将出现在公共大厅中。
- 挑战: 另一位玩家打开
/cf,选择你的下注,并支付匹配的下注金额。
- 动画: 两位玩家同时播放交互式的 50/50 掷硬币动画。
- 派彩: 胜者获得合并彩池减去服务器配置的税费百分比后的金额。
安装与配置
系统先决条件、安装步骤及配置选项。
服务器要求
- 平台: Paper 1.21.1+ (PaperMC 26.1.2+)
- Java 版本: Java 21+
- 依赖项: Vault 及一个兼容 Vault 的经济插件(例如 EssentialsX Economy)。
设置步骤
- 下载最新的
OxCoinFlip.jar。
- 将 jar 文件放入服务器的
plugins/ 目录中。
- 确保已安装 Vault 和经济插件提供商。
- 启动或重启服务器以生成配置文件。
- 根据需要自定义
plugins/OxCoinFlip/config.yml 中的设置。
默认配置示例
game:
min-bet: 100.0
max-bet: 100000000.0
max-active-wagers: 3
tax-percentage: 5.0
可自定义设置
服务器管理员可以在 config.yml 中完全自定义以下选项:
- 最小和最大下注金额
- 每位玩家的最大活跃下注数量
- 税费百分比
- 动画持续时间与翻转速度
- GUI 材质、图标和标题
- 声音与音量控制
- 所有面向玩家的消息及 MiniMessage 格式
致谢
由 ItzRealOrionX 用 ❤️ 开发。
OxCoinFlip
OxCoinFlip is a modern, GUI-based coin flip gambling plugin for Paper servers with Vault economy support.
Create a wager, choose heads or tails, and let another player challenge it. The result is a fair 50/50 coin flip, with the winner receiving the combined pot minus an optional tax.
Core Features
OxCoinFlip offers a complete, secure wagering framework with interactive animations and full customization:
- Fair 50/50 Outcomes: Outcomes are purely random with an even 50/50 chance for heads or tails.
- Vault Economy Integration: Fully compatible with Vault and economy providers like EssentialsX.
- Interactive GUI & Lobby: Active wagers are displayed in a global lobby with an animated coin flip screen upon match start.
- Wager Rules & Limits: Wager creator picks heads or tails; the challenger automatically gets the opposite side. Up to 3 active wagers per player with a maximum default wager of 100,000,000.
- Anti-Exploit & Menu Security: Complete protection against item movement, dragging, shift-clicking, hotbar swaps, and duplicate wager acceptances. Players cannot accept their own wagers.
- Automated Pot & Tax: Instant, safe balance checks; winner takes the combined pot minus a configurable tax. Instant refunds are issued when a wager is removed.
- MiniMessage Formatting: Full support for MiniMessage formatting, custom sound effects, and configurable GUI icons.
Gameplay & Admin Commands
OxCoinFlip provides intuitive player commands for creating, managing, and viewing active wagers.
Player Commands
/cf — Opens the active coin flip lobby GUI (Alias: /coinflip).
/cf create <heads|tails> <amount> — Creates a new coin flip wager (e.g., /cf create heads 1000).
/cf remove <number> — Removes one of your active wagers and refunds the wagered amount immediately.
How It Works
- Create: Run
/cf create <heads|tails> <amount>. Your balance is charged immediately and the wager appears in the public lobby.
- Challenge: Another player opens
/cf, selects your wager, and pays the matching wager amount.
- Animate: An interactive 50/50 coin flip animation plays simultaneously for both players.
- Payout: The winner receives the combined pot minus the server's configured tax percentage.
Installation & Configuration
System prerequisites, installation steps, and configuration options.
Server Requirements
- Platform: Paper 1.21.1+ (PaperMC 26.1.2+)
- Java Version: Java 21+
- Dependencies: Vault and a Vault-compatible economy plugin (e.g., EssentialsX Economy).
Setup Steps
- Download the latest
OxCoinFlip.jar.
- Place the jar file in your server's
plugins/ directory.
- Ensure Vault and an economy provider are installed.
- Start or restart the server to generate configuration files.
- Customize settings in
plugins/OxCoinFlip/config.yml as needed.
Default Configuration Example
game:
min-bet: 100.0
max-bet: 100000000.0
max-active-wagers: 3
tax-percentage: 5.0
Customizable Settings
Server owners can fully customize the following options within config.yml:
- Minimum and maximum wager amounts
- Maximum active wagers per player
- Tax percentage
- Animation duration and flip speed
- GUI materials, icons, and titles
- Sounds and volume controls
- All player-facing messages and MiniMessage formatting
Credits
Developed with ❤️ by ItzRealOrionX.
评论 0
登录后参与评分
还没有评论,来抢沙发吧