Pool and Billiards Datapack by YMS2001

Dependencies

This datapack depends on the following components:

• Required — Pool and Billiards Resource Pack

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

中文版使用说明(GitHub)

Summary of Recent Changes
近期改动总结

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
• Generic 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

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

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

Here are a few helpful commands.

1. Open command window directly without clicking any buttons in chat.
   /function app:help/pool/commandwindow
2. 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
3. Terminate a game without using command window.
   /function pool:classes/lobby/terminate_helper
4. 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:

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