Pool and Billiards

v1.1.0-rc.1

Summary
总结

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.