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!