Pool and Billiards
记得安装资源包！Remember to install the resource pack! One of the most advanced open-source pool and billiards games for Minecraft Java Edition, featuring realistic physics, snooker, eight-ball, nine-ball, multiplayer, and AI opponents.
Автор: YMS200112,5 тыс.40обновлён 24 окт. 2026 г.
ДекорМини-игрыТехнологии
Описание
Pool and Billiards Datapack by YMS2001
It got a website for all info you need!
About
This datapack is designed for Minecraft players who enjoy cue sports.
Here, pool broadly refers to cue sports including Snooker, 8-Ball, 9-Ball, and related variants.
The datapack supports single-player, play-with-bot, and two-player gameplay in Minecraft Java Edition 1.16+. It also fully supports players without OP permission or in survival mode.
Supported game modes:
- Snooker
- UK 8-Ball
- Generic 8-Ball
- 9-Ball
- Rule-free practice mode
Dependencies
This datapack depends on the following component:
- Required — Pool and Billiards Resource Pack
When installing from Modrinth, the compatible resource pack should be installed automatically.
Please use matching versions of the datapack and resource pack whenever possible. If an exact matching resource-pack version is not available, this means the datapack was updated without requiring a resource-pack update; in that case, use the closest earlier compatible resource-pack version.
Make sure the required resource pack is installed and enabled before use.
Detailed README (GitHub)
中文版使用说明(GitHub)
Summary of Recent Changes
近期改动总结
Mod Version
Starting from v1.2.0, the datapack is also available as a mod version.
The mod version automatically loads the datapack, so you do not need to place it into each world’s datapacks folder manually. The regular datapack version is still fully supported.
Installation
1. Download the following for the correct game version
- Pool Datapack
- Pool and Billiards Resource Pack (Please check that the resourcepack has a matching minor version to ensure compatibility, i.e., v1.3.x datapack should use v1.3.x resourcepack)
2. Locate your Minecraft directory
On Windows this is usually:
C:/Users/YourUserName/AppData/Roaming/.minecraft
3. Install the resource pack
Move Pool Resource Pack into:
.minecraft/resourcepacks
4. Install the datapacks
Open the world folder where you want to install the datapacks:
.minecraft/saves/<your world>/datapacks
Move the file into this folder:
- Pool Datapack
Each world requires its own copy of the datapacks.
Alternative mod version, available since v1.2.0
You can download the mod version and place it into .minecraft/mods
The mod version automatically loads the datapack, so you do not need to place it into each world's datapacks folder every time.
5. Start Minecraft and open the world
6. Enable the resource pack
Esc -> Options -> Resource Packs
Move Pool Resource Pack to the enabled side.
7. Run the following command
/reload
8. Enjoy
Here are a few helpful commands.
- Open command window directly without clicking any buttons in chat.
/function app:help/pool/commandwindow
or/trigger swPool__trigger set 1if without permission - Run the loading function, in case you want to troubleshoot / check missing settings and don't want to run
reload.
/function pool:classes/main/load - Terminate a game without using command window.
/function pool:classes/lobby/terminate_helper - Remove a table without using command window.
/function pool:classes/table/clear
Included Mechanics
This datapack includes the following systems:
- Simplified Newtonian physics simulation for pool balls
- Neural network-based rack simulation during the break
- Simplified match setup and game rules
- Chat-based GUI for convenient interaction; most actions are done with the mouse
- Support for English and 简体中文
For performance and clarity, the simulation omits some real-world effects such as friction between pockets and balls, cushion deformation, and other minor physical complexities.
Additional Information
Full documentation, installation and usage guides, and source code are available here:
https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project
Compatibility Note
For Minecraft versions before 1.21, you may need to edit pack.mcmeta to remove the compatibility warning.
The datapack content is mostly identical across supported versions, so adjusting this single file is usually easier than maintaining multiple nearly identical copies.
Please refer to the Pack Format documentation and update pack.mcmeta according to your Minecraft version:
Галерея
Последние версии
Все версии →release
v1.3.7-mc1.21plus for Minecraft 1.21 and future versions
v1.3.7-mc1.21plus+mod24 окт. 2026 г.204Minecraft: 1.21, 1.21.1, 24w33a, 24w34a, 24w35a, 24w36a, 24w37a, 24w38a, 24w39a, 24w40a, 1.21.2-pre1, 1.21.2-pre2, 1.21.2, 1.21.3, 24w44a, 24w45a, 24w46a, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3fabric, forge, neoforge, quilt
Что нового
# v1.3.7
This update introduces a **fully playable Snooker bot**, improves bot planning and shot selection, and adds more options for adjusting difficulty and physics accuracy.
## New Features
- **Added a fully playable Snooker bot!**
- The bot aims to maximize its score while considering the difficulty of future shots.
- Defensive shot searches are triggered when attacking options are poor or when a snooker is needed to win.
- **Added search depth 2 for bot players.**
- The bot can now simulate potential follow-up shots to make better decisions about cue-ball positioning.
- This requires additional computation but is now practical thanks to performance optimizations introduced in previous updates.
- **Added adjustable shot-force accuracy for bot players.**
- Random variation can be applied to the bot's shot force, allowing players to adjust its difficulty.
- Higher accuracy makes the bot more consistent, while lower accuracy introduces more imperfections.
- **Added an adjustable collision detection accuracy setting.**
- Controls how many nearby balls the physics engine checks for potential collisions.
- Higher settings reduce the risk of missed collisions, especially when balls are tightly packed together, as in Snooker, but slightly increase computational load.
- Lower settings are generally sufficient for normal gameplay and offer better performance.
## Bot Improvements
- **Improved shot evaluation** to favor more reasonable cue-ball positioning.
- Added penalties for simulated shots involving excessive cue-ball collisions, as complex trajectories are less predictable.
- Increased penalties for cue-ball collisions with pocket edges, where small inaccuracies can increase the risk of scratching.
- Added gradual penalties for cue-ball positions near cushions, where subsequent shots may be more difficult.
- These adjustments reduce the estimated value of risky follow-up opportunities without completely discouraging difficult or necessary shots, such as breaking up ball clusters.
- Improved the bot's simulation and evaluation scheduler to reduce unexpected deadlocks and interruptions.
## Technical Improvements
- **Added direct position updates using entity NBT as an alternative to teleportation-based ball movement.**
- Simplifies movement calculations, improves positioning accuracy, and reduces the number of commands needed to update ball positions.
- In testing, average motion load decreased by **44.8%**, making the new method approximately **1.8× faster**.
- However, the original teleportation method truncates small displacements, leaving a slight separation between balls. The more precise NBT method reduces this separation, potentially increasing the likelihood of balls clipping through each other due to numerical errors.
- This feature is **disabled by default**. To enable it, run `/function app:settings/pool/motion/use_nbt`.
- For Minecraft 1.17+, Snooker now uses marker entities instead of area effect clouds where applicable.
## Other Changes
- **Removed Simulate ASAP mode.**
- Distributing simulations across multiple game ticks now provides a more practical way to manage computational load.
- Maintaining a separate ASAP simulation path is no longer worthwhile, especially with the introduction of more advanced planning.
- Removed the option to choose between 5 and 10 force/spin combinations per shot and the default is set to 10 combinations, simplifying bot configuration.
release
v1.3.7-mc1.16_1.20 for Minecraft versions 1.16 to 1.20
v1.3.7-mc1.16_1.20+mod24 окт. 2026 г.76Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6fabric, forge, neoforge, quilt
Что нового
See the changelog of v1.3.7-mc1.21plus
release
v1.3.7-mc1.21plus for Minecraft 1.21 and future versions
v1.3.7-mc1.21plus24 окт. 2026 г.47Minecraft: 1.21, 1.21.1, 24w33a, 24w34a, 24w35a, 24w36a, 24w37a, 24w38a, 24w39a, 24w40a, 1.21.2-pre1, 1.21.2-pre2, 1.21.2, 1.21.3, 24w44a, 24w45a, 24w46a, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3datapack
Что нового
# v1.3.7
This update introduces a **fully playable Snooker bot**, improves bot planning and shot selection, and adds more options for adjusting difficulty and physics accuracy.
## New Features
- **Added a fully playable Snooker bot!**
- The bot aims to maximize its score while considering the difficulty of future shots.
- Defensive shot searches are triggered when attacking options are poor or when a snooker is needed to win.
- **Added search depth 2 for bot players.**
- The bot can now simulate potential follow-up shots to make better decisions about cue-ball positioning.
- This requires additional computation but is now practical thanks to performance optimizations introduced in previous updates.
- **Added adjustable shot-force accuracy for bot players.**
- Random variation can be applied to the bot's shot force, allowing players to adjust its difficulty.
- Higher accuracy makes the bot more consistent, while lower accuracy introduces more imperfections.
- **Added an adjustable collision detection accuracy setting.**
- Controls how many nearby balls the physics engine checks for potential collisions.
- Higher settings reduce the risk of missed collisions, especially when balls are tightly packed together, as in Snooker, but slightly increase computational load.
- Lower settings are generally sufficient for normal gameplay and offer better performance.
## Bot Improvements
- **Improved shot evaluation** to favor more reasonable cue-ball positioning.
- Added penalties for simulated shots involving excessive cue-ball collisions, as complex trajectories are less predictable.
- Increased penalties for cue-ball collisions with pocket edges, where small inaccuracies can increase the risk of scratching.
- Added gradual penalties for cue-ball positions near cushions, where subsequent shots may be more difficult.
- These adjustments reduce the estimated value of risky follow-up opportunities without completely discouraging difficult or necessary shots, such as breaking up ball clusters.
- Improved the bot's simulation and evaluation scheduler to reduce unexpected deadlocks and interruptions.
## Technical Improvements
- **Added direct position updates using entity NBT as an alternative to teleportation-based ball movement.**
- Simplifies movement calculations, improves positioning accuracy, and reduces the number of commands needed to update ball positions.
- In testing, average motion load decreased by **44.8%**, making the new method approximately **1.8× faster**.
- However, the original teleportation method truncates small displacements, leaving a slight separation between balls. The more precise NBT method reduces this separation, potentially increasing the likelihood of balls clipping through each other due to numerical errors.
- This feature is **disabled by default**. To enable it, run `/function app:settings/pool/motion/use_nbt`.
- For Minecraft 1.17+, Snooker now uses marker entities instead of area effect clouds where applicable.
## Other Changes
- **Removed Simulate ASAP mode.**
- Distributing simulations across multiple game ticks now provides a more practical way to manage computational load.
- Maintaining a separate ASAP simulation path is no longer worthwhile, especially with the introduction of more advanced planning.
- Removed the option to choose between 5 and 10 force/spin combinations per shot and the default is set to 10 combinations, simplifying bot configuration.
release
v1.3.7-mc1.16_1.20 for Minecraft versions 1.16 to 1.20
v1.3.7-mc1.16_1.2024 окт. 2026 г.15Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6datapack
Что нового
See the changelog of v1.3.7-mc1.21plus
release
v1.3.6 for Minecraft 1.21 and future versions
v1.3.6-mc1.21plus+mod17 сент. 2026 г.1,6 тыс.Minecraft: 1.21, 1.21.1, 24w33a, 24w34a, 24w35a, 24w36a, 24w37a, 24w38a, 24w39a, 24w40a, 1.21.2-pre1, 1.21.2-pre2, 1.21.2, 1.21.3, 24w44a, 24w45a, 24w46a, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3fabric, forge, neoforge, quilt
Что нового
# v1.3.6
This update adds support for Minecraft 26.3 for both the datapack and resource pack.
- Replaced many custom math and physics calculations with Minecraft 26.3's native `/compute` system for improved performance.
- In the 8-ball break benchmark on Minecraft 26.3, compared with v1.3.5:
- Peak MSPT decreased by **25%**, from **8 ms to 6 ms**.
- Mean MSPT decreased by **33%**, from **3 ms to 2 ms**.
No changes were made for Minecraft 1.16–26.2, so there is no need to update from v1.3.5 if you are playing on those versions.
If you are using Minecraft 26.3, give v1.3.6 a try — it is even faster!
release
v1.3.6 for Minecraft 1.21 and future versions
v1.3.6-mc1.21plus17 сент. 2026 г.226Minecraft: 1.21, 1.21.1, 24w33a, 24w34a, 24w35a, 24w36a, 24w37a, 24w38a, 24w39a, 24w40a, 1.21.2-pre1, 1.21.2-pre2, 1.21.2, 1.21.3, 24w44a, 24w45a, 24w46a, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3datapack
Что нового
# v1.3.6
This update adds support for Minecraft 26.3 for both the datapack and resource pack.
- Replaced many custom math and physics calculations with Minecraft 26.3's native `/compute` system for improved performance.
- In the 8-ball break benchmark on Minecraft 26.3, compared with v1.3.5:
- Peak MSPT decreased by **25%**, from **8 ms to 6 ms**.
- Mean MSPT decreased by **33%**, from **3 ms to 2 ms**.
No changes were made for Minecraft 1.16–26.2, so there is no need to update from v1.3.5 if you are playing on those versions.
If you are using Minecraft 26.3, give v1.3.6 a try — it is even faster!
release
v1.3.5 for Minecraft 1.21 and future versions
v1.3.5-mc1.21plus+mod21 авг. 2026 г.793Minecraft: 1.21, 1.21.1, 24w33a, 24w34a, 24w35a, 24w36a, 24w37a, 24w38a, 24w39a, 24w40a, 1.21.2-pre1, 1.21.2-pre2, 1.21.2, 1.21.3, 24w44a, 24w45a, 24w46a, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2fabric, forge, neoforge, quilt
Что нового
# v1.3.5
This update focuses on performance optimization and brings major improvements.
IT RUNS MUCH MORE EFFICIENTLY!
For version-to-version comparison, an 8-ball break was tested in Minecraft 1.21.8 on a Ryzen 9 5900X processor in a clean singleplayer world, using a 6×10 table, default ball radius, 150% break power, 1 GB allocated RAM, PBO enabled, and no resource pack. Each version was tested five times, with load monitored over 10 seconds.
| Version | Peak MSPT Range | Mean MSPT Range |
|---|---:|---:|
| v1.0.0 | 38–39 | 09–10 |
| v1.1.0 | 37–38 | 09–10 |
| v1.2.0 | 51–56 | 10-10 |
| v1.3.1 | 39–44 | 06-06 |
| v1.3.2 | 33–38 | 06-06 |
| v1.3.3 | 28-28 | 06-06 |
| v1.3.4 | 23–25 | 05-05 |
| v1.3.5 | 08–11 | 03–04 |
---
## Performance Improvements
- Heavily optimized math functions and physics-engine logic to reduce unnecessary calculations.
- Restricted player-ball-table interaction checks to players within 50 blocks of the table center.
- Added a directional check to the quick-sorting logic to discard ball pairs that are moving away from each other.
- Greatly reduces peak load in situations where many balls are close together.
- Normal shot processing can now run at as low as ~1 mspt.
- Bot simulation speed is significantly improved, reaching up to ~2× the previous speed.
- Recommended bot performance settings have been adjusted accordingly.
- To further reduce lag spikes, the number of simulation steps per tick is now adjusted dynamically based on the number of moving balls on the table during simulation.
- The setting controls the maximum value, which corresponds to the steps per tick when one ball is moving. During simulation, this value is internally reduced when more balls are moving, such as being halved when two balls are moving.
- Changed to lightweight item detection for various held items in Minecraft 1.20.5 and later.
## Mechanism Changes
- Stopped balls no longer receive physics updates every tick.
- Previously, all stopped balls were still processed each tick. This allowed force to propagate through tightly packed balls within the same tick after an active ball collided with them.
- Now, a stopped ball begins receiving physics updates only after it is affected by a collision. As a result, force propagation through packed balls is more likely to take multiple ticks instead of occurring within a couple of ticks.
- This change substantially reduces the processing cost of normal shots and also contributes significantly to faster bot simulations.
- The practical impact is limited:
- Normal tightly packed situations (i.e., break shots) can be handled by the NN break system, which is unaffected by this change.
- In ordinary gameplay, the visual difference is very small.
## Fixes
- Fixed an issue in UK 8-Ball where foul feedback could unintentionally appear after the break shot without any foul.
- Fixed an issue in practice mode where only one player is given cue ball.
release
v1.3.5 for Minecraft versions 1.16 to 1.20
v1.3.5-mc1.16_1.20+mod21 авг. 2026 г.746Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6fabric, forge, neoforge, quilt
Что нового
Please see v1.3.5-mc1.21plus!
release
v1.3.5 for Minecraft 1.21 and future versions
v1.3.5-mc1.21plus21 авг. 2026 г.113Minecraft: 1.21, 1.21.1, 24w33a, 24w34a, 24w35a, 24w36a, 24w37a, 24w38a, 24w39a, 24w40a, 1.21.2-pre1, 1.21.2-pre2, 1.21.2, 1.21.3, 24w44a, 24w45a, 24w46a, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2datapack
Что нового
# v1.3.5
This update focuses on performance optimization and brings major improvements.
IT RUNS MUCH MORE EFFICIENTLY!
For version-to-version comparison, an 8-ball break was tested in Minecraft 1.21.8 on a Ryzen 9 5900X processor in a clean singleplayer world, using a 6×10 table, default ball radius, 150% break power, 1 GB allocated RAM, PBO enabled, and no resource pack. Each version was tested five times, with load monitored over 10 seconds.
| Version | Peak MSPT Range | Mean MSPT Range |
|---|---:|---:|
| v1.0.0 | 38–39 | 09–10 |
| v1.1.0 | 37–38 | 09–10 |
| v1.2.0 | 51–56 | 10-10 |
| v1.3.1 | 39–44 | 06-06 |
| v1.3.2 | 33–38 | 06-06 |
| v1.3.3 | 28-28 | 06-06 |
| v1.3.4 | 23–25 | 05-05 |
| v1.3.5 | 08–11 | 03–04 |
---
## Performance Improvements
- Heavily optimized math functions and physics-engine logic to reduce unnecessary calculations.
- Restricted player-ball-table interaction checks to players within 50 blocks of the table center.
- Added a directional check to the quick-sorting logic to discard ball pairs that are moving away from each other.
- Greatly reduces peak load in situations where many balls are close together.
- Normal shot processing can now run at as low as ~1 mspt.
- Bot simulation speed is significantly improved, reaching up to ~2× the previous speed.
- Recommended bot performance settings have been adjusted accordingly.
- To further reduce lag spikes, the number of simulation steps per tick is now adjusted dynamically based on the number of moving balls on the table during simulation.
- The setting controls the maximum value, which corresponds to the steps per tick when one ball is moving. During simulation, this value is internally reduced when more balls are moving, such as being halved when two balls are moving.
- Changed to lightweight item detection for various held items in Minecraft 1.20.5 and later.
## Mechanism Changes
- Stopped balls no longer receive physics updates every tick.
- Previously, all stopped balls were still processed each tick. This allowed force to propagate through tightly packed balls within the same tick after an active ball collided with them.
- Now, a stopped ball begins receiving physics updates only after it is affected by a collision. As a result, force propagation through packed balls is more likely to take multiple ticks instead of occurring within a couple of ticks.
- This change substantially reduces the processing cost of normal shots and also contributes significantly to faster bot simulations.
- The practical impact is limited:
- Normal tightly packed situations (i.e., break shots) can be handled by the NN break system, which is unaffected by this change.
- In ordinary gameplay, the visual difference is very small.
## Fixes
- Fixed an issue in UK 8-Ball where foul feedback could unintentionally appear after the break shot without any foul.
- Fixed an issue in practice mode where only one player is given cue ball.
release
v1.3.5 for Minecraft versions 1.16 to 1.20
v1.3.5-mc1.16_1.2021 авг. 2026 г.76Minecraft: 1.16, 1.16.1, 1.16.2, 1.16.3, 1.16.4, 1.16.5, 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6datapack
Что нового
Please see v1.3.5-mc1.21plus!