Content creator: Mingshi Yang (YMS2001). Contact: mingshi3@illinois.edu
I am replacing the math module with a better organized collection: Math Datapack. Please include its latest version in your datapack directory.
Play pool in Minecraft, like in real life!
This datapack is for pool lovers. Pool here means cue sport including Snooker, Billiards, 8/9 Ball, etc.
Pool datapack supports singleplayer and duo games with Minecraft Java Edition 1.16+. The pack is computationally heavy, it supports only one active table in a Minecraft world.
Supported game modes are practice, snooker, and UK 8 ball.
- Step 01 Download this repository as a zip and unpack.
- Step 02 Go to minecraft directory, usually "C:/Users/youUserName/AppData/Roaming/.minecraft".
- Step 03 Move your "Pool-Resourcepack-Squid-Workshop-1.16.5" folder(not the root folder) into .../resourcepacks folder. Pack compatible with 1.16+.
- Step 04 Choose the world folder in which you want to install the packs. Go to .../saves/world/datapacks folder.
- Step 05 Move your "Pool-Datapack-Squid-Workshop-1.16-1.19" folder(not the root folder) into .../saves/world/datapacks folder.
- Step 06 Open Minecraft and open the world.
- Step 07 Press Esc, click options... and resourcepacks... and move Pool-Resourcepack-Squid-Workshop-1.16.5 to the upper right. Do this everytime you change the game version.
- Step 08 Type "/reload" command then press enter.
- Step 09 Enjoy
PS: If not working, check whether the datapack is enabled by:
/datapack list
Enable it by:
/datapack enable "datapackname"
The datapack and resourcepack will work for various game versions, although the game may notify you the packs are incompatible when you install them. Nonetheless, you can follow this page and modify pack.mcmeta files according to your game version.
Please let me know if the packs are actually incompatible with any versions higher than Java Edition 1.16.1.
Most interactions do not require typing. You just need to click on texts in <this format> or choose functions suggested by the game in command line.
You will be displayed a piece of <Clickable text> to open the "command window" after (re)loaded the datapack, try clicking on the text and explore. You can get the command window by running this command at any time:
/function app:help/pool/commandwindow
If the pack is (re)installed, please follow the instruction, choose the language, game version, and set the friction coefficients by clicking the texts. You can also use the following command to modify friction later. Otherwise, there will be zero friction (you may try it for fun)!
/function app:settings/pool/friction/
Suggested values: Impact:100-200, Rolling:150-300, Sliding:1500-3000, Striking:6000-8000. Extereme values may cause the scoreboard calculations to overflow and the game may behave unexpectedly.
Beside the friction coefficients, other settings such as undoing the stroke and reloading can be modified. Please consult the settings explained below.
/function app:settings/
Note: Please turn off "Force Unicode" for better experience.
When you are holding the cue stick, press right button to charge, the longer you hold the right button, the more power the strike is. The cue ball will be moving towards your facing direction.
When you are holding the cue stick, press shift to face the cue ball.
You can choose whether you will be applied slowness effect when pressing shift. This may help you aim, but is not recommended without smooth connection. You can set by completing the following command.
/function app:settings/pool/aim/
Before each strike you can click <Adjust the next strike angles> to change the strike positions and angles. Or using the following command.
/function pool:classes/cue/map
When the cue ball leaves table, the player having it in hand needs to place it back on the table. Valid placements will be indicated by green particles when the player is standing on the table or on the ground near the table.
Install the datapack following instructions of the Installation section.
When prompted, set language, game version, friction parameters, and how the player scores will be displayed.
Click to open the command window, get the cue stick, explore the settings and change them if you want.
Click to set a new table if you haven't done so. Choose two side lengths of the table and place it following text prompts.
Open the game lobby in command window, if you want to participate in multiplayer game, you can click to join the queue beginning with MP. After you join a queue, other players will receive your invitation and are able to join you.
You will be notified when another player joins your queue. Click on BEGIN! to play with that player.
You can also play singleplayer mode, in singleplayer Snooker you just try to score more than you foul. In singleplayer UK 8 Ball you just pretend to be two players, so there is no win or loss in this game.
After a snooker game finishes, players will receive a rating based on average point they get per strike (per turn).
You can initialize practice mode from command window or enter it in the middle of any other games. In practice mode you can place the balls anywhere and there will be no rules.
You can terminate the game at any time using the command window.
Conservation of momentum and angular momentum and energy, recently added interactions with edge of pockets (friction is neglected there) and simulation of cue stick - cue ball interactions. Neglected deformations.
- I am aware of that everything looks amplified, while comparing to reality. This also affects the physics as the radii of balls are one of the most closely related parameters to the physical behaviors. However, the common setting of mouse sensitivity does not provide enough fineness of controlling the cuestick, and it will be much harder to play the game if the balls size are reduced to mimic the real pool balls. Sorry for any "unrealistic concerns" brought to you by my "disloyalty" to the reality.
- Although the content is mostly common knowledge, please do not redistribute without crediting us sufficiently. I have not cited any specific references while making the physics work. See the detailed physics link above or try search "not so simple billiards physics" online.
- The rules of snooker and rules of 8 ball have been simplified to meet popular gameplay. It is likely that the rules are less strict in this datapack. The 2005 dimension of pockets on a snooker table is included in the resourcepack as images.
data/app/functions/settings Comment
+---aim Choose whether the screen will be zoomed in while aiming.
| nozoom.mcfunction Do not zoom in
| zoom.mcfunction Zoom in
|
+---cheating Choose whether cheating is allowed
| allow.mcfunction Allow
| disallow.mcfunction Not allow
|
+---friction Set coefficients of frictions
| clear.mcfunction Clear all values
| default.mcfunction Use default values for all entries below
| impact.mcfunction indiv. value setting
| rolling.mcfunction indiv. value setting
| sliding.mcfunction indiv. value setting
| striking.mcfunction indiv. value setting
|
+---language Choose a language
| chinese_simplified.mcfunction Simplified Chinese
| english.mcfunction English
|
+---reload Upon Reload...
| cleanongoingsession.mcfunction Clear the current game session when you reload the pack
| keepongoingsession.mcfunction Not clear the current game session when you reload the pack
|
+---snooker/display Display of scores in snooker game
| dialogue.mcfunction Tellraw the players in dialogue
| sidebar.mcfunction Show the score at sidebar (may conflict other sidebar objectives)
|
\---version The game version of the map (world)
1_16.mcfunction 1.16.x
1_17.mcfunction 1.17.x
1_18.mcfunction 1.18.x
1_19.mcfunction 1.19.x
reset.mcfunction Let you choose again
Other directories are not shown.
This section shall be honored when in conflict with other documents, including the license.
Feel free to play around with this datapack.
As developer, feel free to use this datapack as a module to develop free datapacks.
But you must notify us and add the link to this github page!
NO COMMERCIAL USE, POTENTIALLY (AT SQUID MINECRAFT WORKSHOP'S DISCRETION) COMMERTIAL USE WITHOUT PROMISSION IS ALSO PROHIBITED.
More datapacks developed by us here
Watch our videos on youtube here
Watch our videos on bilibili here
Join our QQ group: 74681732
Subscribe on wechat: 鱿鱼MC工作室