[Sider module] Ball Server v2.0 For Sider v5.1.0 (with overlay)
[NEW v2.0] New features in version 2 (due to in-game overlay in sider 5.1.0+):
.txt assignment files reloading (key 0) – available at any moment, useful for making quick fixes to .txt assignment files, without needing to restart the game
toggle between manual ball selection and automatic ball assignment via .txt files (key 9)
if manual selection is used, then manually selected ball has priority over the ball which would otherwise be assigned via .txt files
additional options, available only in manual selection mode:
Manual selection by cycling through all the available balls (PageUp/PageDown keys)
IMPORTANT: only the balls which are assigned via .txt files are available for cycling-through!! A ball which exists only as a subfolder in the external content root (content\ball-server), but is not assigned to any team or competition via .txt files WILL NOT be available for manual selection either!
Favorite ball – current manual selection can be saved permanently as a favorite ball (key 7) or recalled to be used later (key 8)
Current version: 2.0
Minimum version of Sider required: 5.1.0
GDB-style unlimited ball management
original ball packaging (identical folder structure and file names, as they are in .cpk files)
ball assignment to individual home teams via map_teams.txt file
ball assignment to competitions via map_competitions.txt file – i.e. all teams participating in particular competition will use identical ball
IMPORTANT: by default, competition assignment always takes priority over team assignment in all modes except Exhibition mode matches
but, there’s a way to override that behavior for any individual competition – by slightly modifying BallServer.lua script itself, you can add/remove competition IDs in override_competitions table, thus defining more or less competitions where team assignment takes priority over competition assignment
support for optional ball to be used in final match only
support for optional ball to be used during winter season
Multiple balls can be assigned to a competition via map_competitions.txt – if more than one ball is available, Ball Server selects one randomly
65535, 207, Ordem V,,,, # exhibition match
65535, 060, Merlin Serie A,,,, # exhibition match
correct ball previews and ball names are displayed in game menus (where available, depending on game mode)
Inaccurate ball selection during replays – due to game design, saved replays do not include tournament_ID – if the ball used in saved replay has been assigned via map_competition.txt, then there is no way to re-select exactly the same ball during replay – exhibition mode ball is most likely going to be selected.
[NEW v2.0] Although all overlay features (manual ball selection, .txt files reloading, …) are available at any moment (and it cannot be done differently, due to the way the overlay currently works in sider), it is not advisable to change any overlay-related settings after the match-loading screen has appeared or during the match. In-game behavior will be unpredictable in such circumstances. You’ve been warned ;) Make your selections BEFORE you hit the Next match button.
How to use:
Unpack v2.0 archive and copy folders content and modules inside your sider 5.1.0 folder (overwrite, if asked)
(If not done already) Add lua.module = “BallServer.lua” at the end of sider.ini
Customize map_teams.txt and map_competitions.txt files and add more ball folders in content\ball-server folder (more instructions can be found inside .txt files)
Additional general-purpose notes related to sider and .lua scripting:
Lua scripts have priority over live cpk root folders. Therefore, if you use Ballserver.lua script, you do not need ball packs in live cpk roots too. It is advisable to remove them, to avoid possible conflicts.
When multiple scripts contend for the same content (e.g. Ballserver and N more scripts that all want to switch the balls), then the script that is listed first/highest in the lua.module section of sider.ini has priority. So, if you intend to use Ballserver as a primary source of custom balls, move lua.module = “BallServer.lua” entry ABOVE other scripts that also serve custom balls.
Nothing to do with Ballserver itself, this is general sider command – if you have multiple scripts that use overlay, than use key 1 to cycle through them and choose which script is currently shown on the overlay (Ballserver.lua, camera.lua, …)
@juce and @nesa24 for sider
@Hawke for the ball-pack included in v1.0
Link v2.0 (base pack + @Hawke’s ball pack (1st version!!)
Latest version of the ball pack by @Hawke is not included in v2.0. You can update the ball pack by following the instructions in @Hawke’s thread, after you’ve updated the Ballserver.