GobangGame MC
这是 Minecraft Bukkit Server 插件 版本的 GobangGame
参见 GobangGame 了解我制作的原始桌面程序
描述
一款 Minecraft 插件,将经典棋类 五子棋 (Gobang) 带入 Minecraft,拥有精美的 GUI 界面和多玩家支持。
安装
服务器管理员
- 从 Github Release 页面或 Modrinth Versions 页面下载最新的
GobangGameMC.jar
- 将 JAR 文件放入服务器的
plugins/ 文件夹中
- 重启服务器
- 玩家现在可以使用
/gobanggame 进行游戏!
? 命令
| 命令 |
描述 |
权限 |
/gobanggame |
打开主菜单 |
gobanggame.use |
/gg |
/gobanggame 的别名 |
gobanggame.use |
/gobanggame invite <player> |
邀请玩家加入游戏 |
gobanggame.invite |
/gobanggame accept <player> |
接受邀请 |
gobanggame.accept |
/gobanggame deny <player> |
拒绝邀请 |
gobanggame.use |
/gobanggame quit |
离开当前游戏 |
gobanggame.use |
/gobanggame help |
显示帮助菜单 |
gobanggame.use |
? 玩法说明
开始游戏:
- 输入
/gobanggame 打开主菜单
- 点击“创建新游戏”以邀请一名玩家
- 从在线列表中选择一名玩家
- 他们将收到邀请通知
- 一旦对方接受,游戏即开始!
游戏规则:
- 黑方 先手,白方 后手
- 玩家轮流放置棋子
- 连成 5 颗棋子 即可获胜(横、竖或斜)
- 每步棋限时 60 秒
- 如果棋盘完全填满,则判为平局
游戏界面:
- 顶部 5 行:15x15 棋盘(显示前 45 个格子)
- 底部一行:游戏信息和控件
- 回合指示器:显示当前轮到谁下(黑色/白色染料)
- 退出按钮:红色屏障用于离开游戏
⚙️ 配置
首次运行后,将在 plugins/GobangGameMC/ 目录下生成一个 config.yml 文件:
# Gobang Game Configuration
version: 1.0
# Game Settings
game:
turn-time: 60 # 每回合秒数
board-size: 15 # 棋盘大小 (15x15)
max-games: 10 # 最大同时进行的对局数
# Invitations
invitations:
timeout: 300 # 超时时间(秒),即 5 分钟
max-pending: 5 # 每位玩家的最大待处理邀请数
# Performance
performance:
autosave-interval: 300 # 每 5 分钟保存一次游戏
cleanup-interval: 600 # 每 10 分钟清理旧数据
? 权限
| 权限 |
描述 |
默认值 |
gobanggame.use |
使用主命令 |
true |
gobanggame.invite |
邀请玩家 |
true |
gobanggame.accept |
接受邀请 |
true |
gobanggame.admin |
管理员命令 |
op |
? 故障排除
常见问题:
- 插件无法启用:
- 确保您使用的是 Java 21 或更高版本
- 检查服务器日志中的错误
- 验证 plugin.yml 格式是否正确
- 命令无效:
- 输入 /reload confirm 重新加载插件
- 检查是否拥有所需权限
- 确保您使用的是 Minecraft 1.21.11+
- GUI 未打开:
- 确保您是玩家身份(而非控制台)
- 检查与其他插件的背包冲突
- 胜利判定不工作:
- 确认您有 5 颗棋子连成直线
- 检查服务器日志中的胜利判定错误
? 贡献
欢迎贡献!以下是您可以提供帮助的方式:
- Fork 本仓库
- 创建功能分支:git checkout -b feature/amazing-feature
- 提交更改:git commit -m 'Add amazing feature'
- 推送到分支:git push origin feature/amazing-feature
- 发起 Pull Request
? 致谢
- Mojang for Minecraft
- SpigotMC for the plugin API
- PaperMC for server optimizations
? 支持
? 游戏预览
[Player1] invited you to play Gobang!
Use /gobanggame accept Player1 to accept
══════════════════════════════════════
Player1 defeated Player2
in a game of Gobang!
══════════════════════════════════════
享受在 Minecraft 中玩五子棋的乐趣吧! ?⚫⚪
GobangGame MC
This is a Minecraft Bukkit Server plugin version of GobangGame
See GobangGame for the original desktop program made by me
Description
A Minecraft plugin that brings the classic game of Gobang (Five in a Row) into Minecraft with beautiful GUI interfaces and multiplayer support.
Installation
For server owners
- Download the latest
GobangGameMC.jar from Github Release page or the Modrinth Versions page
- Place the JAR file in your server's
plugins/ folder
- Restart your server
- Players can now use
/gobanggame to play!
? Commands
| Command |
Description |
Permission |
/gobanggame |
Open main menu |
gobanggame.use |
/gg |
Alias for /gobanggame |
gobanggame.use |
/gobanggame invite <player> |
Invite a player to play |
gobanggame.invite |
/gobanggame accept <player> |
Accept an invitation |
gobanggame.accept |
/gobanggame deny <player> |
Deny an invitation |
gobanggame.use |
/gobanggame quit |
Leave current game |
gobanggame.use |
/gobanggame help |
Show help menu |
gobanggame.use |
? How to Play
Starting a game:
- Type
/gobanggame to open the main menu
- Click "Create New Game" to invite a player
- Select a player from the online list
- They'll receive an invitation notification
- Once they accept, the game begins!
Game rules:
- Black goes first, White goes second
- Players take turns placing their pieces
- Connect 5 pieces in a row to win (horizontal, vertical, or diagonal)
- You have 60 seconds per move
- If the board fills completely, it's a draw
Game interface:
- Top 5 rows: 15x15 game board (showing first 45 slots)
- Bottom row: Game information and controls
- Turn Indicator: Shows whose turn it is (black/white dye)
- Quit Button: Red barrier to leave the game
⚙️ Configuration
After first run, a config.yml file will be created in plugins/GobangGameMC/:
# Gobang Game Configuration
version: 1.0
# Game Settings
game:
turn-time: 60 # Seconds per turn
board-size: 15 # Size of the board (15x15)
max-games: 10 # Maximum concurrent games
# Invitations
invitations:
timeout: 300 # 5 minutes in seconds
max-pending: 5 # Max pending invites per player
# Performance
performance:
autosave-interval: 300 # Save games every 5 minutes
cleanup-interval: 600 # Clean up old data every 10 minutes
? Permissions
| Permission |
Description |
Default |
gobanggame.use |
Use main commands |
true |
gobanggame.invite |
Invite players |
true |
gobanggame.accept |
Accept invitations |
true |
gobanggame.admin |
Admin commands |
op |
? Troubleshooting
Common Issues:
- Plugin won't enable:
- Ensure you're using Java 21 or higher
- Check server logs for errors
- Verify plugin.yml is correctly formatted
- Commands not working:
- Type /reload confirm to reload plugins
- Check that you have the required permissions
- Ensure you're using Minecraft 1.21.11+
- GUI not opening:
- Make sure you're a player (not console)
- Check for inventory conflicts with other plugins
- Win detection not working:
- Verify you have 5 pieces in a straight line
- Check server logs for win detection errors
? Contributing
Contributions are welcome! Here's how you can help:
- Fork the repository
- Create a feature branch: git checkout -b feature/amazing-feature
- Commit your changes: git commit -m 'Add amazing feature'
- Push to the branch: git push origin feature/amazing-feature
- Open a Pull Request
? Acknowledgments
- Mojang for Minecraft
- SpigotMC for the plugin API
- PaperMC for server optimizations
? Support
? Game Preview
[Player1] invited you to play Gobang!
Use /gobanggame accept Player1 to accept
══════════════════════════════════════
Player1 defeated Player2
in a game of Gobang!
══════════════════════════════════════
Enjoy playing Gobang in Minecraft! ?⚫⚪
评论 0
登录后参与评分
还没有评论,来抢沙发吧