Pool and Billiards Datapack by YMS2001

Dependencies

This datapack depends on the following components:

• Required — Pool and Billiards Resource Pack
• Bundled since v1.0.0-rc.2 (no manual install needed) — Scoreboard Math Datapack

Make sure all required components are installed and enabled before use.

中文版使用说明(GitHub)

---

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 and two-player gameplay in Minecraft Java Edition 1.16+.

Supported game modes:

• Snooker
• UK 8-Ball
• Chinese 8-Ball
• 9-Ball
• Rule-free practice mode

---

Installation

1. Download the following for the correct game version

• Pool Datapack
• Pool and Billiards Resource Pack
• Scoreboard Math Datapack (if needed)

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 both files into this folder:

• Pool Datapack
• Math Datapack (if needed)

Each world requires its own copy of the datapacks.

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. Recommended setting

/gamerule maxCommandChainLength 131072

Or max_command_sequence_length depending on version.

9. Enjoy

---

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:

https://minecraft.fandom.com/wiki/Data_pack#Pack_format