# Pool and Billiards Datapack by YMS2001<\/p>\n
## About<\/p>\n
This datapack is designed for Minecraft players who enjoy cue sports.
\nHere, _pool_ broadly refers to cue sports including **Snooker, 8-Ball, 9-Ball**, and related variants.<\/p>\n
The datapack supports **single-player and two-player gameplay** in **Minecraft Java Edition 1.16+**. It also fully supports players without OP permission or in survival mode since v1.2.0.<\/p>\n
Supported game modes:<\/p>\n
* Snooker
\n* UK 8-Ball
\n* Generic 8-Ball
\n* 9-Ball
\n* Rule-free practice mode<\/p>\n
***<\/p>\n
## Dependencies<\/p>\n
**This datapack depends on the following components:**<\/p>\n
* _Required_ \u2014 Pool and Billiards Resource Pack <\/p>\n
**Make sure all required components are installed and enabled before use.**<\/p>\n
Detailed README (GitHub)
\n\u4e2d\u6587\u7248\u4f7f\u7528\u8bf4\u660e(GitHub)<\/p>\n
Summary of Recent Changes
\n\u8fd1\u671f\u6539\u52a8\u603b\u7ed3 <\/p>\n
### Mod Version<\/p>\n
Starting from **v1.2.0**, datapack is also available as a **mod version**<\/p>\n
The mod version automatically loads the datapack, so you do not need to manually place the datapack into each world’s `datapacks` folder every time. This can be more convenient if you frequently create new worlds or use a modded launcher\/profile. **You still need to make sure that the resourcepack is enabled,** but Modrinth loader should automatically handle the downloading.<\/p>\n
The regular datapack version is still fully supported.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
**1. Download the following for the correct game version**<\/p>\n
* Pool Datapack
\n* Pool and Billiards Resource Pack<\/p>\n
**2. Locate your Minecraft directory**<\/p>\n
On Windows this is usually:<\/p>\n
“`
\nC:\/Users\/YourUserName\/AppData\/Roaming\/.minecraft
\n“`<\/p>\n
**3. Install the resource pack**<\/p>\n
Move **Pool Resource Pack** into:<\/p>\n
“`
\n.minecraft\/resourcepacks
\n“`<\/p>\n
**4. Install the datapacks**<\/p>\n
Open the world folder where you want to install the datapacks:<\/p>\n
“` Move the file into this folder:<\/p>\n * Pool Datapack<\/p>\n Each world requires its own copy of the datapacks.<\/p>\n **Alternative mod version**, available since v1.2.0<\/p>\n You can download the mod version and place it into `.minecraft\/mods`<\/p>\n The mod version automatically loads the datapack, so you do not need to place it into each world’s `datapacks` folder every time.<\/p>\n **5. Start Minecraft and open the world**<\/p>\n **6. Enable the resource pack**<\/p>\n “` Move **Pool Resource Pack** to the enabled side.<\/p>\n **7. Run the following command**<\/p>\n “` **8. Enjoy**<\/p>\n ### Here are a few helpful commands. ***<\/p>\n ## Included Mechanics<\/p>\n This datapack includes the following systems:<\/p>\n * Simplified **Newtonian physics simulation** for pool balls 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.<\/p>\n ***<\/p>\n ## Additional Information<\/p>\n Full documentation, installation and usage guides, and source code are available here:<\/p>\n https:\/\/github.com\/MingshiYangUIUC\/Pool-Minecraft-Squid-Workshop-Project<\/p>\n ***<\/p>\n ### Compatibility Note<\/p>\n For Minecraft versions **before 1.21**, you may need to edit `pack.mcmeta` to remove the compatibility warning.<\/p>\n The datapack content is mostly identical across supported versions, so adjusting this single file is usually easier than maintaining multiple nearly identical copies.<\/p>\n Please refer to the Pack Format documentation and update `pack.mcmeta` according to your Minecraft version:<\/p>\n https:\/\/minecraft.fandom.com\/wiki\/Data_pack#Pack_format<\/p>\n","protected":false},"excerpt":{"rendered":" Immersive, fully playable single and multiplayer pool games built entirely in Vanilla Minecraft.<\/p>\n","protected":false},"featured_media":123805,"template":"","meta":{"_minecraft_slug":"pool-and-billiards","_minecraft_project_id":"mksguUIH","_minecraft_author":"YMS2001","_minecraft_license":"MPL-2.0","_minecraft_downloads":1176,"_minecraft_follows":10,"_minecraft_client_side":"unknown","_minecraft_server_side":"unknown","_minecraft_storage_type":"zip","_minecraft_archive_name":"pool-and-billiards.zip","_minecraft_size_bytes":7123893,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T05:08:03.157949Z","_minecraft_date_created":"2026-03-12T09:00:51.143203Z","_minecraft_date_modified":"2026-05-11T22:38:55.465426Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pool-and-billiards","_minecraft_icon_attachment_id":123805,"_minecraft_imported_at":"2026-06-07T06:41:58+00:00","_minecraft_import_hash":"a4419132e41f11e746a533fa07ee3ed9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,156,88,97,104,89,866,158,98,123,92],"mod_loader":[86,99,106,160,100],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,71,72,74,38,78,79,80,81,82,63,64,65,66,67,68,69,70,75,76,77,83,167,163],"class_list":["post-123804","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-decoration","mod_category-equipment","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-minigame","mod_category-neoforge","mod_category-quilt","mod_category-technology","mod_category-utility","mod_loader-datapack","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-2-pre1","minecraft_version-1-21-2-pre2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-24w33a","minecraft_version-24w34a","minecraft_version-24w35a","minecraft_version-24w36a","minecraft_version-24w37a","minecraft_version-24w38a","minecraft_version-24w39a","minecraft_version-24w40a","minecraft_version-24w44a","minecraft_version-24w45a","minecraft_version-24w46a","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n.minecraft\/saves\/
\n“`<\/p>\n
\nEsc -> Options -> Resource Packs
\n“`<\/p>\n
\n\/reload
\n“`<\/p>\n
\n1. Open command window directly without clicking any buttons in chat.
\n\t`\/function app:help\/pool\/commandwindow`
\n or `\/trigger swPool__trigger set 1` if without permission
\n2. Run the loading function, in case you want to troubleshoot \/ check missing settings and don’t want to run `reload`.
\n\t`\/function pool:classes\/main\/load`
\n3. Terminate a game without using command window.
\n\t`\/function pool:classes\/lobby\/terminate_helper`
\n4. Remove a table without using command window.
\n\t`\/function pool:classes\/table\/clear`<\/p>\n
\n* **Neural network-based rack simulation** during the break
\n* Simplified **match setup and game rules**
\n* **Chat-based GUI** for convenient interaction; most actions are done with the mouse
\n* Support for **English** and **\u7b80\u4f53\u4e2d\u6587**<\/p>\n