ВЕРСИИ (40)

# 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.

See the changelog of v1.3.7-mc1.21plus

# 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.

See the changelog of v1.3.7-mc1.21plus

# 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!

# 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!

# 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.

Please see v1.3.5-mc1.21plus!

# 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.

Please see v1.3.5-mc1.21plus!

# 1.3.4 This update focuses on a "distributed" bot thinking strategy, free ball rule for Snooker, and additional performance optimization and fixes. --- ## Improvements - Assigned fixed UUIDs to helper entities and the pool-table marker to make entity selection slightly faster. Helper entities `rhp1`–`rhp3`: ``` UUID:[I;797665,435737,0,4-6] # swPool, helper, 0, #4-#6 000c2be1-0006-a619-0000-00000000000[4-6] ``` Pool-table marker: ``` UUID:[I;797665,82253,0,0] # swPool, table, 0, 0 000c2be1-0001-414d-0000-000000000000 ``` - Reduced the frequency of `OnGround` NBT checks to once every 4 ticks. - Reduced entity position reads after movement by accumulating position from the previously stored position and movement speed instead. Full position reads are now performed once every 10 ticks. - For Minecraft 1.21+, reduced unnecessary calculations during spin rendering by normalizing quaternions less frequently, now once every 10 ticks. These optimizations reduced active-gameplay MSPT by up to approximately 17% compared with v1.3.3 in a testing scenario outlined in README. ## Changes / Additions - Dynamic pool-table scaling now supports ball radii above `1250`, up to `1500`. Please use multiples of 250 for best results. - If the ball-spinning feature is turned off, balls will no longer spin during the pocketing animation. - The bot can now distribute its thinking time across multiple ticks. This helps prevent short lag spikes, and the maximum number of simulation steps per tick can be configured based on the processing power of the client or server. - Fixed static ball-rendering issues when the bot is thinking. - Added a slight penalty for shots that are too straight, as they often make positioning for the next shot harder. - Added an [experimental] Snooker free ball mechanism - After a foul, the datapack can detect whether the incoming player is snookered and award a free ball when applicable. - The first ball hit is treated as the nominated free ball. - If the nominated free ball is potted, it scores the same value as the original ball on. - A free ball is not awarded when the incoming player already has ball in hand in the D-Zone. - Revised Chinese language terminology: ball in hand (cue ball replacement) is now referred to as 手中球 in all games, while a Snooker free ball is referred to as 自由球. - Shortened the name of release zip files and included version number. ## Fixes - Fixed a 9-ball rule issue where potting a lower-numbered ball after illegally hitting the next higher-numbered ball first was not correctly identified as a foul. - Fixed a bug where players sometimes could not shoot when pressing Shift.

Please see the update log for mc1.21plus

# 1.3.4 This update focuses on a "distributed" bot thinking strategy, free ball rule for Snooker, and additional performance optimization and fixes. --- ## Improvements - Assigned fixed UUIDs to helper entities and the pool-table marker to make entity selection slightly faster. Helper entities `rhp1`–`rhp3`: ``` UUID:[I;797665,435737,0,4-6] # swPool, helper, 0, #4-#6 000c2be1-0006-a619-0000-00000000000[4-6] ``` Pool-table marker: ``` UUID:[I;797665,82253,0,0] # swPool, table, 0, 0 000c2be1-0001-414d-0000-000000000000 ``` - Reduced the frequency of `OnGround` NBT checks to once every 4 ticks. - Reduced entity position reads after movement by accumulating position from the previously stored position and movement speed instead. Full position reads are now performed once every 10 ticks. - For Minecraft 1.21+, reduced unnecessary calculations during spin rendering by normalizing quaternions less frequently, now once every 10 ticks. These optimizations reduced active-gameplay MSPT by up to approximately 17% compared with v1.3.3 in a testing scenario outlined in README. ## Changes / Additions - Dynamic pool-table scaling now supports ball radii above `1250`, up to `1500`. Please use multiples of 250 for best results. - If the ball-spinning feature is turned off, balls will no longer spin during the pocketing animation. - The bot can now distribute its thinking time across multiple ticks. This helps prevent short lag spikes, and the maximum number of simulation steps per tick can be configured based on the processing power of the client or server. - Fixed static ball-rendering issues when the bot is thinking. - Added a slight penalty for shots that are too straight, as they often make positioning for the next shot harder. - Added an [experimental] Snooker free ball mechanism - After a foul, the datapack can detect whether the incoming player is snookered and award a free ball when applicable. - The first ball hit is treated as the nominated free ball. - If the nominated free ball is potted, it scores the same value as the original ball on. - A free ball is not awarded when the incoming player already has ball in hand in the D-Zone. - Revised Chinese language terminology: ball in hand (cue ball replacement) is now referred to as 手中球 in all games, while a Snooker free ball is referred to as 自由球. - Shortened the name of release zip files and included version number. ## Fixes - Fixed a 9-ball rule issue where potting a lower-numbered ball after illegally hitting the next higher-numbered ball first was not correctly identified as a foul. - Fixed a bug where players sometimes could not shoot when pressing Shift.

Please see the update log for mc1.21plus

# 1.3.3 This update focuses on performance optimization, several bot and respotting fixes, and small usability improvements. --- ## Performance Improvements - Improved tick-function efficiency by reducing idle processing and the number of entity selectors. - Improved ball-in-hand placement performance and behavior. - Placement is now limited to a range of 10 blocks, so please remain near the table while placing a ball. - Placement now activates only when the player is looking downward by at least 10 degrees. - Replaced many entity-tag checks with scoreboard checks to improve efficiency. - Added bounding-box constraints to entity selectors where possible, reducing the impact of large numbers of irrelevant nearby entities. - Removed several unnecessary entity selectors. - Reduced unnecessary calculation precision when updating armor-stand poses for ball-spin animations. ## Fixes - Fixed a known issue in v1.3.2 that could incorrectly mute sound effects during bot mode. - Fixed the 9-ball respot option sometimes not appearing in manual mode. - Fixed the 8-ball bot sometimes failing to detect a successful hit during the break shot. ## Other Changes - The single-player bot mode button is now hidden when automatic judging is disabled. - Improved snooker color-ball respotting. - Players are no longer given the ball-in-hand tag when no color balls need to be respotted.

See the update log of 1.21plus

# 1.3.3 This update focuses on performance optimization, several bot and respotting fixes, and small usability improvements. --- ## Performance Improvements - Improved tick-function efficiency by reducing idle processing and the number of entity selectors. - Improved ball-in-hand placement performance and behavior. - Placement is now limited to a range of 10 blocks, so please remain near the table while placing a ball. - Placement now activates only when the player is looking downward by at least 10 degrees. - Replaced many entity-tag checks with scoreboard checks to improve efficiency. - Added bounding-box constraints to entity selectors where possible, reducing the impact of large numbers of irrelevant nearby entities. - Removed several unnecessary entity selectors. - Reduced unnecessary calculation precision when updating armor-stand poses for ball-spin animations. ## Fixes - Fixed a known issue in v1.3.2 that could incorrectly mute sound effects during bot mode. - Fixed the 9-ball respot option sometimes not appearing in manual mode. - Fixed the 8-ball bot sometimes failing to detect a successful hit during the break shot. ## Other Changes - The single-player bot mode button is now hidden when automatic judging is disabled. - Improved snooker color-ball respotting. - Players are no longer given the ball-in-hand tag when no color balls need to be respotted.

See the update log of 1.21plus

# v1.3.2 This update adds a lightweight bot instant mode, mainly to make bot games more practical in multiplayer worlds. It also improves the settings menu and in-game documentation, adds support for dynamic ball radii in bot mode, and fixes several issues. --- ## Main features ### 1. Bot improvements - Added instant mode for games with the bot. - In instant mode, the bot does not run shot simulations. - This greatly reduces calculation load and is useful when lag is not desired, especially in multiplayer worlds. - However, the bot may perform significantly worse in this mode. - Added a multiplayer warning when setting up a game with the bot. - If a multiplayer session is detected, the datapack warns that bot calculations may cause lag. - The warning also provides a clickable option to enable instant mode. - Added support for dynamic ball radii in bot mode. - This feature is still experimental and testing is limited. Feedback is welcome. - Smaller ball radii may have a higher likelihood of numerical errors. --- ### 2. Improved documentation and settings menu - Drastically improved the in-game settings menu. - Settings are now organized into subcategories, making them easier to locate and understand. - Added and improved localization for many setting descriptions. - Added a concise in-game user guide. --- ## Fixes and adjustments - Corrected the bot delay recommendation. - The recommended delay is based on **10 force-spin combinations**. - Fixed an issue where “play with bot” could interfere with normal single-player mode. - In some cases, the cue ball might not be given correctly in normal single-player games. - Fixed a Eight-ball rule issue. - When the table was open, failing to hit any object ball was not always identified as a foul. - Added support for item-display tables in bot mode when the ball radius is set to `1250`. - Restricted bot games to whitelisted players when the settings whitelist is enabled. - This helps prevent unintentional lag caused by bot games on shared servers. - Adjusted reload behavior. - `/reload` no longer force-resets the following settings: - allow cheat - enable ball-spinning animation - keep ongoing session - These options are still enabled by default during initial installation. - Small performance improvements. - Reduced repeated command calls. - Optimized the arctangent calculation.

See the log of 1.21plus

# v1.3.2 This update adds a lightweight bot instant mode, mainly to make bot games more practical in multiplayer worlds. It also improves the settings menu and in-game documentation, adds support for dynamic ball radii in bot mode, and fixes several issues. --- ## Main features ### 1. Bot improvements - Added instant mode for games with the bot. - In instant mode, the bot does not run shot simulations. - This greatly reduces calculation load and is useful when lag is not desired, especially in multiplayer worlds. - However, the bot may perform significantly worse in this mode. - Added a multiplayer warning when setting up a game with the bot. - If a multiplayer session is detected, the datapack warns that bot calculations may cause lag. - The warning also provides a clickable option to enable instant mode. - Added support for dynamic ball radii in bot mode. - This feature is still experimental and testing is limited. Feedback is welcome. - Smaller ball radii may have a higher likelihood of numerical errors. --- ### 2. Improved documentation and settings menu - Drastically improved the in-game settings menu. - Settings are now organized into subcategories, making them easier to locate and understand. - Added and improved localization for many setting descriptions. - Added a concise in-game user guide. --- ## Fixes and adjustments - Corrected the bot delay recommendation. - The recommended delay is based on **10 force-spin combinations**. - Fixed an issue where “play with bot” could interfere with normal single-player mode. - In some cases, the cue ball might not be given correctly in normal single-player games. - Fixed a Eight-ball rule issue. - When the table was open, failing to hit any object ball was not always identified as a foul. - Added support for item-display tables in bot mode when the ball radius is set to `1250`. - Restricted bot games to whitelisted players when the settings whitelist is enabled. - This helps prevent unintentional lag caused by bot games on shared servers. - Adjusted reload behavior. - `/reload` no longer force-resets the following settings: - allow cheat - enable ball-spinning animation - keep ongoing session - These options are still enabled by default during initial installation. - Small performance improvements. - Reduced repeated command calls. - Optimized the arctangent calculation.

See the log of 1.21plus

# v1.3.1 This hotfix fixed the missing bot angle-spread setting. - It now appears in the settings menu. - It is now correctly mapped to the trigger system for non-OP players. Players using v1.3.0 with command permission can still access this setting directly with: `/function app:settings/pool/bot/angle_std` Alternatively, please update to v1.3.1. # v1.3.0 This update introduces the first playable Minecraft pool bot across all supported versions include recent **Minecraft 26.2**, together with substantial cross-version performance improvements and an optional whitelist-based permission system for shared servers. Minecraft 1.21 and later additionally receive configurable ball radius, dynamic table scaling, item-display-based table rendering, and related table-size controls. --- ## Main features ### 1. Configurable ball radius and dynamic table scaling *Minecraft 1.21 and later only* - Added support for changing the pool-ball radius in Minecraft 1.21 and later. - The default radius remains `1250`. - Table dimensions, including table length, width, pocket size, and related placement offsets, can now be calculated dynamically from the selected ball radius. - Pocket-center and pocket-edge positions are now configured dynamically. - Increased the physics engine detection limit to support smaller ball radii. - Redesigned the Minecraft 1.21+ table-rendering system to support dynamic scaling. - Replaced table-related item frames with item displays. - Item displays allow table components to be positioned and scaled according to the selected ball radius. - Cloth rendering now uses a solid cloth color where appropriate to avoid texture-stretching artifacts. - Added an optional perfectly scaled 1×2 table mode. - This allows the playable area to retain an exact 1:2 width-to-length ratio for players who prefer accurate table proportions. - Enable this option in the settings menu and select any 1×2 table-size combination, such as 4×8 or 6×12, for it to take effect. - Added a fixed table-scale option. - By default, pockets and other table components scale with the selected ball radius when a new table is placed. - `equipment/table_scale_fix` keeps the pockets and related table components at the dimensions used for the default ball radius. - `equipment/table_scale_unfix` restores radius-dependent scaling. - This recovers the previous ability to change only the ball size without changing the table and fake-ball dimensions. - It can also be used to slightly reduce the game difficulty by decreasing the ball radius while keeping the table dimensions unchanged. --- ### 2. Pool Bot ### a. Supported games - Added full bot support for: - **8-ball**, the primary and highest-priority supported bot game. - **9-ball**, which has a smaller legal action space and is generally simpler for the bot to evaluate. - Added a **start-with-bot** option to single-player games. - This turns a single-player session into a two-player game between the player and the bot. - Added supporting bot behavior for: - Game-specific rules and legal-target handling. - Cue-stick movement animation when the bot shoots. - Ball-in-hand situations. - Snooker get-out situations. - Muting normal game sounds during internal simulations. - Replaced area-effect-cloud helper entities with markers in Minecraft 1.17 and later where applicable. - This improves the visual appearance of bot actions and related helper behavior. ### b. Bot difficulty and performance settings - Added configurable bot difficulty and performance settings. - Added control over the number of aim points evaluated by the bot. - Higher values allow the bot to evaluate more candidate shots. - Evaluating more aim points generally makes the bot stronger, but also increases its thinking time. - Because the benefit decreases as more lower-ranked shots are added, and the most difficult shot is unlikely to be the best choice, the default value is `2`. - Added configurable random shot-angle spread. - Lower values produce more accurate shot execution and therefore a stronger bot. - Higher values introduce more aiming error. - Adjust this setting according to your preferred difficulty. - Added two force-spin action spaces: - `action_space_5`: evaluates 5 force-spin combinations per aim point. - `action_space_10`: evaluates 10 force-spin combinations per aim point and generally makes the bot stronger. - Added configurable tick time allocated to each bot simulation. - Increasing this value gives the game more time to recover between simulations. - This helps prevent lag from accumulating and reduces the catch-up acceleration that may otherwise occur after intensive simulations. - Recommended values are based on the 5-combination action space and may need to be doubled when using the 10-combination action space. - The configured tick time is also used to calculate the total delay between scheduled bot simulations. ### c. Bot decision logic #### - Candidate action generation - The bot currently prioritizes direct potting attempts. - The design assumption is that sufficiently accurate direct shots can handle most normal situations. - Bank shots, combination shots, swerve shots, and dedicated safety-shot actions are not currently included in the primary action space. - However, the bot may occasionally identify one of these shots as favorable during simulation and choose to play it. - Candidate actions are generated from legal target-ball and pocket pairs. - Actions with cut angles greater than 90 degrees are rejected. - Actions with obviously blocked cue-ball paths are removed before computationally expensive simulation. - The bot precomputes the relative distance `D` and angle `A` between each object ball and the cue ball. - The offset between the aiming direction and the direction toward another object ball is used for obstruction checks. - A target path may be treated as blocked when: `D × sin(A) < 2 × ball radius` and the obstructing ball is closer than the selected aim point. - A squared-vector form is used to avoid unnecessary square-root calculations. - If the path from a legal target ball to the selected pocket is blocked, the action is penalized rather than completely removed. - These actions remain valid because collisions or combination shots may still produce a favorable result. #### - Initial shot-quality estimate - Each candidate action receives an initial score `S`, representing the approximate probability of potting the target ball. - `S` is estimated using fitted linear relationships based on: - Cue-ball-to-target-ball distance. - Target-ball-to-pocket distance. - Cut angle. - The incoming-path angle relative to the direction faced by the pocket. - These relationships were derived from 200,000 offline simulations. - Candidate actions are ranked using this initial estimate before full simulations are performed. #### - Simulation and action evaluation - The number of evaluated aim points and force-spin combinations determines the approximate bot thinking time. - The bot simulates a selected number of highly ranked actions and evaluates the resulting table state. - Each simulated action is also evaluated using the estimated quality of the best available action on the bot’s next turn. - The general evaluation structure is: `FS = S × (R + S_next_best)` where: - `FS` is the final evaluation score for the current action. - `S` is the estimated quality of the current shot. - When `R ≠ 1`, `S` is set to `1` so that non-potting outcomes are evaluated directly from the shot result and resulting table state. - `R` represents the result of the current shot: - `1`: a successful pot. - `0`: no successful pot. - `-1`: a foul. - `2`: a win. - `-2`: a loss. - `S_next_best` is the estimated quality of the best available action on the bot’s next turn. - The evaluation also: - Penalizes resulting positions with too few available actions, reducing the chance of the bot getting stuck. - Rewards positions that preserve possible shots on multiple object balls. - The bot selects the action and force-spin combination with the highest final evaluation score. #### - Fallback behavior - If no normal candidate actions are available because all paths are blocked or no pocket path can be found: - The bot attempts a randomly selected target ball. - It additionally tests shots in 12 distributed directions. #### - Ball-in-hand and break-shot behavior - During ball-in-hand: - The bot tests random legal cue-ball placements. - It favors placements that produce a high value for the best currently available shot. - Normal action evaluation is then performed from the selected position. - During a break shot: - The bot places the cue ball at a random legal location. - The bot then attempts to hit the first ball fully with high power. #### - Silent rollout system - Added an efficient silent-simulation pipeline that evaluates candidate shots and returns their results. - During each simulation, the system: 1. Records the current ball positions and game state. 2. Creates static ball displays to preserve the visible table state. 3. Hides the actual physics-enabled balls and mutes all related sound effects. 4. Simulates the candidate shot using the hidden actual balls until all balls stop moving. 5. Evaluates and records the shot result according to the applicable game rules. 6. Restores the original ball positions and game state. 7. Removes the temporary static ball displays. 8. Reveals the actual balls and restores normal sound effects. --- ### 3. Server permissions and settings access - Added an optional whitelist restriction for table management and protected settings. - As requested in issue #23, restricted features include table configuration and placement, as well as global settings. - Player-specific settings and normal game controls, such as starting or stopping a game, remain unrestricted. - The whitelist restriction can only be enabled or disabled by an OP. - The enable and disable controls remain direct function commands rather than trigger-based commands. - Players without command permission cannot activate them. - When whitelist restriction is enabled: - The OP enabling the restriction is automatically added to the whitelist. - OPs retain full administrative control. - OPs can add or remove the `swPool_whitelisted` tag from players. - Whitelisted players can access protected settings and table-management functions. - Whitelisted non-OP players cannot enable or disable the whitelist or modify whitelist membership. - Other non-OP players cannot access protected settings or table-management functions. - In the settings menu, restricted entries are displayed in gray to players who do not have permission. - Restricted scoreboard triggers used by settings are enabled only for whitelisted players. - When whitelist restriction is disabled: - All players can access settings and table-management functions as before. - Access restrictions are enforced within the trigger system itself, so restricted settings cannot be bypassed by manually entering their trigger values. - In single-player worlds without command permission: - The whitelist cannot be enabled. - The player can continue to use all normal trigger-accessible features. - This preserves normal single-player usability because whitelist restrictions are not useful in this situation. --- ### 4. Performance improvements - Substantially improved datapack performance, making repeated bot simulations practical across all supported versions. - Reduced repeated entity-selector usage by moving more operations into helper functions. - Reduced unnecessary square-root calculations. - Reduced unnecessary precision in spin calculations for a significant performance improvement. --- ### 5. Fixes and gameplay refinements - Fixed a rule-logic bug affecting replacement of colored balls in snooker. - Optimized rack placement locations for all supported games. - Added cushion restitution behavior. --- ### 6. Scope decisions - Bot simulation is currently built and tuned around the default ball radius of `1250`. - Support for variable ball radii is not included yet, but will likely be added in a future version. - Full snooker bot gameplay is not included. - Snooker requires substantially more complex rule handling, stronger decision-making algorithms, and significantly more computing power. - Bank shots, combination shots, swerve shots, and dedicated safety-shot actions are not explicitly included in the current normal action-selection system. - They are lower priorities because direct shots cover the main intended gameplay. - However, the bot may still occasionally discover and select some of these shots during simulation. --- ### 7. Upgrade and gameplay notes - It is recommended to completely remove existing tables after updating to v1.3.0 and then place them again. - This ensures that each table uses the updated entity types, scaling logic, pocket placement, and rendering system. - Automatic judging must be enabled when playing with the bot. - Some settings can become inconsistent if they are changed after a table has already been placed. - For example, changing the ball radius without replacing the table may create mismatched ball and table dimensions. - Normal behavior is not guaranteed in these cases. - Avoid setting friction values too low when playing with the bot. - Lower friction causes simulated shots to take much longer to finish, which substantially increases bot simulation and thinking time. - Avoid using the bot on multiplayer servers or during time-sensitive single-player gameplay, such as combat or other hazardous survival situations. - Bot simulations are very unlikely to finish within a single game tick under normal hardware conditions. - The required computation can cause noticeable lag and may negatively affect other players or make time-sensitive situations unsafe.

Please see the update log of Datapack v1.3.1-mc1.21plus

[Summary](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/CHANGELOG.md) [总结](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97.md) # v1.3.1 This hotfix fixed the missing bot angle-spread setting. - It now appears in the settings menu. - It is now correctly mapped to the trigger system for non-OP players. Players using v1.3.0 with command permission can still access this setting directly with: `/function app:settings/pool/bot/angle_std` Alternatively, please update to v1.3.1. # v1.3.0 This update introduces the first playable Minecraft pool bot across all supported versions, including the recent **Minecraft 26.2**, together with substantial cross-version performance improvements and an optional whitelist-based permission system for shared servers. Minecraft 1.21 and later additionally receive configurable ball radius, dynamic table scaling, item-display-based table rendering, and related table-size controls. --- ## Main features ### 1. Configurable ball radius and dynamic table scaling *Minecraft 1.21 and later only* - Added support for changing the pool-ball radius in Minecraft 1.21 and later. - The default radius remains `1250`. - Table dimensions, including table length, width, pocket size, and related placement offsets, can now be calculated dynamically from the selected ball radius. - Pocket-center and pocket-edge positions are now configured dynamically. - Increased the physics engine detection limit to support smaller ball radii. - Redesigned the Minecraft 1.21+ table-rendering system to support dynamic scaling. - Replaced table-related item frames with item displays. - Item displays allow table components to be positioned and scaled according to the selected ball radius. - Cloth rendering now uses a solid cloth color where appropriate to avoid texture-stretching artifacts. - Added an optional perfectly scaled 1×2 table mode. - This allows the playable area to retain an exact 1:2 width-to-length ratio for players who prefer accurate table proportions. - Enable this option in the settings menu and select any 1×2 table-size combination, such as 4×8 or 6×12, for it to take effect. - Added a fixed table-scale option. - By default, pockets and other table components scale with the selected ball radius when a new table is placed. - `equipment/table_scale_fix` keeps the pockets and related table components at the dimensions used for the default ball radius. - `equipment/table_scale_unfix` restores radius-dependent scaling. - This recovers the previous ability to change only the ball size without changing the table and fake-ball dimensions. - It can also be used to slightly reduce the game difficulty by decreasing the ball radius while keeping the table dimensions unchanged. --- ### 2. Pool Bot ### a. Supported games - Added full bot support for: - **8-ball**, the primary and highest-priority supported bot game. - **9-ball**, which has a smaller legal action space and is generally simpler for the bot to evaluate. - Added a **start-with-bot** option to single-player games. - This turns a single-player session into a two-player game between the player and the bot. - Added supporting bot behavior for: - Game-specific rules and legal-target handling. - Cue-stick movement animation when the bot shoots. - Ball-in-hand situations. - Snooker get-out situations. - Muting normal game sounds during internal simulations. - Replaced area-effect-cloud helper entities with markers in Minecraft 1.17 and later where applicable. - This improves the visual appearance of bot actions and related helper behavior. ### b. Bot difficulty and performance settings - Added configurable bot difficulty and performance settings. - Added control over the number of aim points evaluated by the bot. - Higher values allow the bot to evaluate more candidate shots. - Evaluating more aim points generally makes the bot stronger, but also increases its thinking time. - Because the benefit decreases as more lower-ranked shots are added, and the most difficult shot is unlikely to be the best choice, the default value is `2`. - Added configurable random shot-angle spread. - Lower values produce more accurate shot execution and therefore a stronger bot. - Higher values introduce more aiming error. - Adjust this setting according to your preferred difficulty. - Added two force-spin action spaces: - `action_space_5`: evaluates 5 force-spin combinations per aim point. - `action_space_10`: evaluates 10 force-spin combinations per aim point and generally makes the bot stronger. - Added configurable tick time allocated to each bot simulation. - Increasing this value gives the game more time to recover between simulations. - This helps prevent lag from accumulating and reduces the catch-up acceleration that may otherwise occur after intensive simulations. - Recommended values are based on the 5-combination action space and may need to be doubled when using the 10-combination action space. - The configured tick time is also used to calculate the total delay between scheduled bot simulations. ### c. Bot decision logic #### - Candidate action generation - The bot currently prioritizes direct potting attempts. - The design assumption is that sufficiently accurate direct shots can handle most normal situations. - Bank shots, combination shots, swerve shots, and dedicated safety-shot actions are not currently included in the primary action space. - However, the bot may occasionally identify one of these shots as favorable during simulation and choose to play it. - Candidate actions are generated from legal target-ball and pocket pairs. - Actions with cut angles greater than 90 degrees are rejected. - Actions with obviously blocked cue-ball paths are removed before computationally expensive simulation. - The bot precomputes the relative distance `D` and angle `A` between each object ball and the cue ball. - The offset between the aiming direction and the direction toward another object ball is used for obstruction checks. - A target path may be treated as blocked when: `D × sin(A) < 2 × ball radius` and the obstructing ball is closer than the selected aim point. - A squared-vector form is used to avoid unnecessary square-root calculations. - If the path from a legal target ball to the selected pocket is blocked, the action is penalized rather than completely removed. - These actions remain valid because collisions or combination shots may still produce a favorable result. #### - Initial shot-quality estimate - Each candidate action receives an initial score `S`, representing the approximate probability of potting the target ball. - `S` is estimated using fitted linear relationships based on: - Cue-ball-to-target-ball distance. - Target-ball-to-pocket distance. - Cut angle. - The incoming-path angle relative to the direction faced by the pocket. - These relationships were derived from 200,000 offline simulations. - Candidate actions are ranked using this initial estimate before full simulations are performed. #### - Simulation and action evaluation - The number of evaluated aim points and force-spin combinations determines the approximate bot thinking time. - The bot simulates a selected number of highly ranked actions and evaluates the resulting table state. - Each simulated action is also evaluated using the estimated quality of the best available action on the bot’s next turn. - The general evaluation structure is: `FS = S × (R + S_next_best)` where: - `FS` is the final evaluation score for the current action. - `S` is the estimated quality of the current shot. - When `R ≠ 1`, `S` is set to `1` so that non-potting outcomes are evaluated directly from the shot result and resulting table state. - `R` represents the result of the current shot: - `1`: a successful pot. - `0`: no successful pot. - `-1`: a foul. - `2`: a win. - `-2`: a loss. - `S_next_best` is the estimated quality of the best available action on the bot’s next turn. - The evaluation also: - Penalizes resulting positions with too few available actions, reducing the chance of the bot getting stuck. - Rewards positions that preserve possible shots on multiple object balls. - The bot selects the action and force-spin combination with the highest final evaluation score. #### - Fallback behavior - If no normal candidate actions are available because all paths are blocked or no pocket path can be found: - The bot attempts a randomly selected target ball. - It additionally tests shots in 12 distributed directions. #### - Ball-in-hand and break-shot behavior - During ball-in-hand: - The bot tests random legal cue-ball placements. - It favors placements that produce a high value for the best currently available shot. - Normal action evaluation is then performed from the selected position. - During a break shot: - The bot places the cue ball at a random legal location. - The bot then attempts to hit the first ball fully with high power. #### - Silent rollout system - Added an efficient silent-simulation pipeline that evaluates candidate shots and returns their results. - During each simulation, the system: 1. Records the current ball positions and game state. 2. Creates static ball displays to preserve the visible table state. 3. Hides the actual physics-enabled balls and mutes all related sound effects. 4. Simulates the candidate shot using the hidden actual balls until all balls stop moving. 5. Evaluates and records the shot result according to the applicable game rules. 6. Restores the original ball positions and game state. 7. Removes the temporary static ball displays. 8. Reveals the actual balls and restores normal sound effects. --- ### 3. Server permissions and settings access - Added an optional whitelist restriction for table management and protected settings. - As requested in issue #23, restricted features include table configuration and placement, as well as global settings. - Player-specific settings and normal game controls, such as starting or stopping a game, remain unrestricted. - The whitelist restriction can only be enabled or disabled by an OP. - The enable and disable controls remain direct function commands rather than trigger-based commands. - Players without command permission cannot activate them. - When whitelist restriction is enabled: - The OP enabling the restriction is automatically added to the whitelist. - OPs retain full administrative control. - OPs can add or remove the `swPool_whitelisted` tag from players. - Whitelisted players can access protected settings and table-management functions. - Whitelisted non-OP players cannot enable or disable the whitelist or modify whitelist membership. - Other non-OP players cannot access protected settings or table-management functions. - In the settings menu, restricted entries are displayed in gray to players who do not have permission. - Restricted scoreboard triggers used by settings are enabled only for whitelisted players. - When whitelist restriction is disabled: - All players can access settings and table-management functions as before. - Access restrictions are enforced within the trigger system itself, so restricted settings cannot be bypassed by manually entering their trigger values. - In single-player worlds without command permission: - The whitelist cannot be enabled. - The player can continue to use all normal trigger-accessible features. - This preserves normal single-player usability because whitelist restrictions are not useful in this situation. --- ### 4. Performance improvements - Substantially improved datapack performance, making repeated bot simulations practical across all supported versions. - Reduced repeated entity-selector usage by moving more operations into helper functions. - Reduced unnecessary square-root calculations. - Reduced unnecessary precision in spin calculations for a significant performance improvement. --- ### 5. Fixes and gameplay refinements - Fixed a rule-logic bug affecting replacement of colored balls in snooker. - Optimized rack placement locations for all supported games. - Added cushion restitution behavior. --- ### 6. Scope decisions - Bot simulation is currently built and tuned around the default ball radius of `1250`. - Support for variable ball radii is not included yet, but will likely be added in a future version. - Full snooker bot gameplay is not included. - Snooker requires substantially more complex rule handling, stronger decision-making algorithms, and significantly more computing power. - Bank shots, combination shots, swerve shots, and dedicated safety-shot actions are not explicitly included in the current normal action-selection system. - They are lower priorities because direct shots cover the main intended gameplay. - However, the bot may still occasionally discover and select some of these shots during simulation. --- ### 7. Upgrade and gameplay notes - It is recommended to completely remove existing tables after updating to v1.3.0 and then place them again. - This ensures that each table uses the updated entity types, scaling logic, pocket placement, and rendering system. - Automatic judging must be enabled when playing with the bot. - Some settings can become inconsistent if they are changed after a table has already been placed. - For example, changing the ball radius without replacing the table may create mismatched ball and table dimensions. - Normal behavior is not guaranteed in these cases. - Avoid setting friction values too low when playing with the bot. - Lower friction causes simulated shots to take much longer to finish, which substantially increases bot simulation and thinking time. - Avoid using the bot on multiplayer servers or during time-sensitive single-player gameplay, such as combat or other hazardous survival situations. - Bot simulations are very unlikely to finish within a single game tick under normal hardware conditions. - The required computation can cause noticeable lag and may negatively affect other players or make time-sensitive situations unsafe.

Please see the update log of Datapack v1.3.1-mc1.21plus

# v1.2.0 [Summary](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/CHANGELOG.md) [总结](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97.md) This is the first public release where the default datapack fully supports non-operators and survival-mode players. It also comes with recipe-based item access and several small fixes/refinements. ## Special Thanks - Special thanks to the community voters who emphasized the need of non-operator and survival-mode player support. --- ## Main changes - The default datapack is now the modified Datapack-**NoOP** version. - It supports survival-mode players and players without command permissions. - The original OP/function-call version is renamed to Datapack-**Base** and kept mainly for development. It will only appear in source code repository. - Some advanced (but rarely used) features may still require command permissions (changing TP duration, gamerule tweaks, etc.). - **NoOP** version added trigger-based command access. - Use `/trigger swPool__trigger set 1` to open the command window. - If no language is selected and the command window does not show correctly, the datapack will prompt you to choose a language. - Most settings may be reset when updating to this version, so you may need to re-apply them. - Added recipe support for survival players in **Minecraft 1.20.5+**. - When recipes are enabled and the player is not in Creative mode, cue sticks and pool tables must be obtained through crafting. - This crafting requirement can be turned on or off. - Recipes are not supported in 1.20.4 and older versions because recipe outputs cannot store custom components, and I do not want to replace existing vanilla recipes. - Recipes are stored in `Recipes` folder and are added to the datapacks by the building script. To some degree, you can customize the registry and rebuild the datapack to use your own recipes. --- ## Survival / NoOP features - Added craftable cue sticks. - Cue sticks are unbreakable bows. - During a game, please keep your offhand slot empty. The game may give you arrows with a green check mark, invisible to other players, so you can keep shooting. - Before entering the practice mode, please keep your inventory as empty as possible. All variants of balls will be given to you. - Added craftable pool table cores. - A table core is a custom chest that stores the selected table cloth and rim type information. - The recipe is intentionally designed to be stratightforward for easier setup. - When placed, the datapack detects the chest location, summon a temporary helper entity, and uses the item data to set the table cloth and rim settings. - The table core item is placed inside the chest, so the player can cancel placement and take back the same item. - The table placement message is slightly different from the normal global table setup message. - When the player confirms placement, the chest and the item inside are removed and the table is created at the chest location. - The temporary helper entity lasts for 60 seconds. If it expires, the player needs to take the table core item out of the chest and place it again. --- ## Settings - Ball spinning is now **ON by default**. Max number of commands in a tick is automatically raised to 500000. --- ## Fixes and refinements - Small efficiency improvements that reduces the use of helper entities during collision detection. - Optimized the resource pack file structure for custom cloths. - Refined the corner pocket resource pack models for more accurate rendering. - Fixed a 9-ball respot bug when auto judge is off. - Trimmed all scoreboard objective names so character count is less or equal to 16. - Provide a copy of readme in the datapack folders. --- ## Documentation - Added a section for non-OP users, including survival-mode users. --- ## Testing - Tested datapack without command permission in several versions. (1.16, 1.17, 1.18, 1.20.6, 1.21.2, 1.21.8, 26.2) - Tested crafting recipes in several 1.20.5+ versions. (1.20.6, 1.21.2, 1.21.8, 26.2)

See the log for 1.21plus

# v1.2.0 [Summary](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/CHANGELOG.md) [总结](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97.md) This is the first public release where the default datapack fully supports non-operators and survival-mode players. It also comes with recipe-based item access and several small fixes/refinements. ## Special Thanks - Special thanks to the community voters who emphasized the need of non-operator and survival-mode player support. --- ## Main changes - The default datapack is now the modified Datapack-**NoOP** version. - It supports survival-mode players and players without command permissions. - The original OP/function-call version is renamed to Datapack-**Base** and kept mainly for development. It will only appear in source code repository. - Some advanced (but rarely used) features may still require command permissions (changing TP duration, gamerule tweaks, etc.). - **NoOP** version added trigger-based command access. - Use `/trigger swPool__trigger set 1` to open the command window. - If no language is selected and the command window does not show correctly, the datapack will prompt you to choose a language. - Most settings may be reset when updating to this version, so you may need to re-apply them. - Added recipe support for survival players in **Minecraft 1.20.5+**. - When recipes are enabled and the player is not in Creative mode, cue sticks and pool tables must be obtained through crafting. - This crafting requirement can be turned on or off. - Recipes are not supported in 1.20.4 and older versions because recipe outputs cannot store custom components, and I do not want to replace existing vanilla recipes. - Recipes are stored in `Recipes` folder and are added to the datapacks by the building script. To some degree, you can customize the registry and rebuild the datapack to use your own recipes. --- ## Survival / NoOP features - Added craftable cue sticks. - Cue sticks are unbreakable bows. - During a game, please keep your offhand slot empty. The game may give you arrows with a green check mark, invisible to other players, so you can keep shooting. - Before entering the practice mode, please keep your inventory as empty as possible. All variants of balls will be given to you. - Added craftable pool table cores. - A table core is a custom chest that stores the selected table cloth and rim type information. - The recipe is intentionally designed to be stratightforward for easier setup. - When placed, the datapack detects the chest location, summon a temporary helper entity, and uses the item data to set the table cloth and rim settings. - The table core item is placed inside the chest, so the player can cancel placement and take back the same item. - The table placement message is slightly different from the normal global table setup message. - When the player confirms placement, the chest and the item inside are removed and the table is created at the chest location. - The temporary helper entity lasts for 60 seconds. If it expires, the player needs to take the table core item out of the chest and place it again. --- ## Settings - Ball spinning is now **ON by default**. Max number of commands in a tick is automatically raised to 500000. --- ## Fixes and refinements - Small efficiency improvements that reduces the use of helper entities during collision detection. - Optimized the resource pack file structure for custom cloths. - Refined the corner pocket resource pack models for more accurate rendering. - Fixed a 9-ball respot bug when auto judge is off. - Trimmed all scoreboard objective names so character count is less or equal to 16. - Provide a copy of readme in the datapack folders. --- ## Documentation - Added a section for non-OP users, including survival-mode users. --- ## Testing - Tested datapack without command permission in several versions. (1.16, 1.17, 1.18, 1.20.6, 1.21.2, 1.21.8, 26.2) - Tested crafting recipes in several 1.20.5+ versions. (1.20.6, 1.21.2, 1.21.8, 26.2)

See the log for 1.21plus

# v1.1.0 [Summary](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/CHANGELOG.md) [总结](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97.md) The stable release `v1.1.0` building upon `v1.1.0-rc.1`. Most features were introduced in the release candidate, with this version focusing on additional testing, fixes and improvements. --- ## Special Thanks - In the release candidate, some features and improvements were inspired by discussions with the community --- ## Bug Fixes since v1.1.0-rc.1 - Fixed a critical issue where collision detection did not correctly adjust based on relative speed - Fixed a syntax error in the detect-out-of-table function in mc1.21+ - Fixed an issue where random quaternions were not being rendered before any shot was taken - Fixed a bug in 8-ball (solid/stripe and red/yellow logic) where the target ball was not correctly switched to the black ball --- ## Improvements since v1.1.0-rc.1 - Made `keepongoingsession` the default behavior - Made break power and cue ball deflection values player-specific instead of global - Added `terminate current game` button to the game lobby --- ## Testing - Conducted additional multiplayer testing via LAN worlds

See the change log of mc1.21plus

## v1.1.0-rc.1 [Summary](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/CHANGELOG.md) [总结](https://github.com/MingshiYangUIUC/Pool-Minecraft-Squid-Workshop-Project/blob/main/%E6%9B%B4%E6%96%B0%E6%97%A5%E5%BF%97.md) --- ## Special Thanks - Some features and improvements were inspired by discussions with the community. --- ## Performance and Logic - Confirmed compatibility with Minecraft version 26.1.2 - Improved installation notices for new players - Allowed cheats by default --- ## Improvements - Make required configuration settings more explicit - Updated the color of installation messages for better visibility (Credit: Bilibili @74071024) - Included required settings directly within the table generation messages - Added automatic prompts to facilitate language selection --- ## Bug Fixes - Fixed a non-critical bug where 9-ball games continued after officially ending - Fixed a non-critical bug in practice mode where undoing a shot incorrectly removed the cue ball from the inventory - Added detection for "ball out of table" bug; automatically undoes the shot and prompts the user to report if it persists - Fixed an issue with the object ball "ball-in-hand" indicator in multiplayer caused by target selectors - Fixed game lag caused by entities (armor stands) experiencing very high angular velocity --- ## Table Settings - Added particle preview for table size (Credit: CurseForge @Snezfennico and Bilibili @1383472410) - Added table rim customization using various trapdoors and signs (Credit: CurseForge @Snezfennico) - Enhanced overall table rim aesthetics (Credit: Bilibili @74071024) - Improved the structure of the table - Implemented empty space detection during placement preview; tables can still be placed regardless of result (Credit: Bilibili @1383472410) --- ## Game - Added a custom rule window ### Auto-judge - Manual enforcement mode (when auto-judge is OFF): - Bypasses most of the progression system, allowing players to enforce rules manually - Displays the ball-in-hand command to all players after every turn - Defines valid ball-in-hand scopes in chat: - 8-Ball and 9-Ball: Anywhere - UK 8-Ball: Kitchen (includes description) - Snooker: D-zone (includes description) - Snooker when auto-judge is OFF: - Added a score adjustment window - Added the ability to manually trigger a ball-in-hand state to replace all colored balls - Original ball spots are now visually indicated using particles - Added a refresh score button - 9-Ball when auto-judge is OFF: - Retained the respot function ### Rule Adjustments - Added a toggle for hit-rail requirements (Credit: CurseForge @Snezfennico) - When disabled, balls do not need to touch the rail to avoid a foul in 8-Ball and 9-Ball - Added a toggle for notifications showing which specific rule was violated - Added a toggle to allow role-switching in single-player 8-Ball games - Consolidated rule feedback, hit-rail, and auto-judge statuses into the same settings window - Implemented manual force setting and adjustment; provided 100 levels in the cue ball strike window to override bow charge mechanics --- ## Display Customization (Resource Pack) *General idea inspired by CurseForge @Snezfennico* - Table cloth color options - Ability to customize cue stick models - Updated logic to use custom tags instead of custom models to detect items - Sets the technical foundation for future variants of cue sticks and shots - Ball appearance customization (Low priority, deferred) --- ## Localizations & Documentation - Renamed "Chinese 8-Ball" to "8-Ball" for international feel - Auto-judge now explicitly instructs valid ball-in-hand locations based on the active game mode - Registered and finalized current rule/equipment settings into the system - Added clickable functions within setting help menus - Indicated that OP permissions are required for set-value functions - Improved Markdown formatting and added images to the changelog - Document key settings and helper functions (language, load, command window, settings) - Clarified table zones by noting that the Kitchen and D-zone are located in the "long positive direction" - Added a warning advising players not to stand too close to the table when placing balls - Updated documentation messages regarding allowed cheats - Added version number to `pack.mcmeta` --- ## To Do Before Full Release - Conduct more multiplayer testing - Please contact me with bugs! - Detect-out-of-table function is still buggy! I will fix!

See the log of mc1.21plus

Updates since v1.0.0-rc.2 Game Logic - Fixed missing progression message when entering practice mode directly from other game modes. - Except in practice mode, if player is given ball in hand, the game removes cue ball item from the assigned player when reverting. Stability and Performance - Increased detection radius for more stable ball tracking. - Improved functions to reduce overflow risk at high ball speeds. - Optimized collision time detection by removing the use of helper entity. - Fixed score assignment issues involving static entities during relative velocity calculations. Documentation - Added in-game game descriptions in the lobby window. - Added more usage notes and tips to README. Compatibility - Extended item display support across all Minecraft 1.21+ versions. Clarified item display as a 1.21+ exclusive feature. - Added support for Minecraft 26.1, revalidated pack.mcmeta configuration. - Note: If future Minecraft versions only require updating `pack.mcmeta` for compatibility, a new release may not be published for this change alone. Users can manually adjust `pack.mcmeta` to remove compatibility warnings if needed. Visual Adjustments - Improved rotation constraints in Pose/Quaternion update logic. - Adjusted snooker particle height (lowered by 0.5 blocks). Known Limitations - Documented scoreboard overflow limitations: Large X/Z coordinates may cause overflow, leading to incorrect positioning or calculations. Table setup may fail at extreme distances from world origin and a warning will appear.

Updates since v1.0.0-rc.2 Game Logic - Fixed missing progression message when entering practice mode directly from other game modes. - Except in practice mode, if player is given ball in hand, the game removes cue ball item from the assigned player when reverting. Stability and Performance - Increased detection radius for more stable ball tracking. - Improved functions to reduce overflow risk at high ball speeds. - Optimized collision time detection by removing the use of helper entity. - Fixed score assignment issues involving static entities during relative velocity calculations. Documentation - Added in-game game descriptions in the lobby window. - Added more usage notes and tips to README. Compatibility - Extended item display support across all Minecraft 1.21+ versions. Clarified item display as a 1.21+ exclusive feature. - Added support for Minecraft 26.1, revalidated pack.mcmeta configuration. - Note: If future Minecraft versions only require updating `pack.mcmeta` for compatibility, a new release may not be published for this change alone. Users can manually adjust `pack.mcmeta` to remove compatibility warnings if needed. Visual Adjustments - Improved rotation constraints in Pose/Quaternion update logic. - Adjusted snooker particle height (lowered by 0.5 blocks). Known Limitations - Documented scoreboard overflow limitations: Large X/Z coordinates may cause overflow, leading to incorrect positioning or calculations. Table setup may fail at extreme distances from world origin and a warning will appear.

v1.0.0-rc.2-mc1.21 For Minecraft 1.21 versions The math datapack v1.0.0 is now built in, so no separate download is required. You can now manually adjust cue ball left / right deflection when shooting. Aiming is disabled while balls are still moving to prevent unintended aiming. Navigation is smoother with added return buttons in menus, and in-game messages have been improved for clarity. Download links and documentation have also been updated.

v1.0.0-rc.2-mc1.16_1.20 For Minecraft versions 1.16 to 1.20 The math datapack v1.0.0 is now built in, so no separate download is required. You can now manually adjust cue ball left / right deflection when shooting. Aiming is disabled while balls are still moving to prevent unintended aiming. Navigation is smoother with added return buttons in menus, and in-game messages have been improved for clarity. Download links and documentation have also been updated.

Initial upload

Initial upload