PES 2017 Sider module Stadium Server v1.3

PES 2017 Sider module Stadium Server v1.3 by zlac - Вашему вниманию, обновлённая программа для добавления стадионов без использования cpk файлов, для футбольного симулятора Pro Evolution Soccer 2017

Current version: 1.3
Minimum version of Sider required: 3.4.2

Features:
# GDB-style unlimited stadium management - add as many stadiums as you want in a GDB-like folder structure

# Mostly unchanged stadium packaging - stadium structure remains almost identical to the .cpk version, meaning that entire stadium directory tree (starting with "common" folder) can be copy-pasted into one top-level GDB folder. These folders from the usual stadium-related cpk-tree are currently supported:

common\bg\model\bg ad, audi, bill, cheer, effect, pitch, scarecrow, sky, stadium, staff, tv (bigflag, cornerflag and goal in v1.1)
common\demo\fixdemo end, ent (change, goal and result in v1.1)
common\demo\anime\behavior\fixdemo\animations (v1.1)
common\demo\fixdemoobj\passage (v1.1)
common\demo\light (v1.1)
common\demo\mob\mob_* (v1.1)
common\render\model\bg\hit bill, stadium
common\render\thumbnail\stadium

IMPORTANT: db files (common\etc\...) for stadium registration are not required. DO NOT INCLUDE THOSE!!​

# Stadium assignment to individual home teams via map_teams.txt file - pretty much self-explanatory, see the supplied map_teams.txt file for examples of how to connect team ID with one GDB-stadium
# Stadium assignment to competitions via map_competitions.txt file - use it to connect competition/tournament ID with one or more stadiums from GDB.

All teams participating in particular competition can either use identical stadium (if ony one stadium is assigned to that competition) or have one of the stadiums assigned randomly (v1.1 feature) if there's more than one stadium assigned to that competition.

## v1.1 - It is possible to assign unlimited number of stadiums to the same competition - in this case, ONE RANDOM stadium will be selected for every home team that:

participates in that competition, BUT DOES NOT have individual stadium assigned in map_teams.txt file

Code:
39, 003, Villa Park, Villa Park, , , # EPL
39, 017, Turf Moor, Turf Moor, , , # EPL
39, 020, White Hart Lane, White Hart Lane, , , # EPL

IMPORTANT: by default, competition assignment would always take priority over team assignment in any game mode, but that can be easily configured within .lua script.

To override this default behavior you have to slightly modify StadiumServer.lua script itself - add/remove competition IDs in override_competitions table, thus defining more or less competitions where individual team assignments from map_teams.txt takes priority over competition assignment from map_competitions.txt

Since v1.1, because of newly introduced random stadium selection option for competitions, override_competitions table has been vastly increased to include all exhibition, league and league-cup matches - you can keep individual stadiums for those teams that already have one in map_teams.txt, while all the other teams without individual stadium would get randomly selected stadium from map_competitions.txt

## Support for optional stadium to be used in final match of the competition only - again, pretty much self-explanatory. See map_competitions.txt file for more details

v1.1 - CAUTION: if multiple stadiums are assigned to a single competition and you want to use specific stadium for finals, then you must include stadium for final match IN EVERY stadium assignment

Code:
84, 003, Villa Park, Villa Park, 004, Wembley, Wembley # FA Cup
84, 017, Turf Moor, Turf Moor, 004, Wembley, Wembley # FA Cup
84, 020, White Hart Lane, White Hart Lane, 004, Wembley, Wembley # FA Cup

# Exhibition mode behavior [v1.3] - stadium assignment logic has been refined to be more in-line with the usual game behavior:

IMPORTANT CHANGE: Stadium server will be active in exhibition mode ONLY if you have selected either "Home ground" or "Random" setting. This enables you to use any stadium from your .cpk pack and additional stadium server's stadiums side by side.

"Random" setting in exhibition mode is going to select stadium either from your .cpk pack or from stadium server's repository.

Complementing this change, additional lua table is available, to customize which teams should keep their .cpk+EDIT assigned home grounds (e.g. Barcelona -> Konami's Camp Nou, Team X -> Stadium X from your .cpk, etc.). See this post for an example.

# Correct stadium previews and stadium names - displayed in game menus (where available, depending on game mode) and scoreboards
# Support for replay mode [v1.3]
# Stadium server is deactivated in edit mode

Current limitations/issues:

1. adboards handling - by default, stadium server will load common\bg\model\bg\bill related files (including config.xml!!) if they exist within custom stadium files. If you'd like to use your already configured .cpk adboards packs, you can comment-out single line of code in StadiumServer.lua to disable adboards serving (see the code, it is noted where that line of code is)

2. IMPORTANT: cooperation with other .lua scripts that use "set_stadium" event - unfortunately, because of the way the stadiums are structured and handled by the game, it was necessary for StadiumServer.lua to use set_stadium event to force the game to use the exact stadium ID of the new stadium, in order to load all the files that belong to that stadium. Another approach, which would not "steal" set_stadium event (i.e. trying to override the files of any stadium that the game would like to use) did not prove successful, because stadiums simply are not file-for-file compatible, causing various artifacts when trying to replace e.g. stadium using ID 016 with custom stadium using any other ID

Bottom-line - if you want StadiumServer to work, you must not use any other .lua scripts that use set_stadium event to change stadium_id

you can still use additional .lua scripts to modify stadium conditions (day/night, weather, summer/winter) by using newly introduced set_conditions event (see Sider 3.3.4 release notes) - just to be on the safe side of the story, place your set_conditions related scripts below StadiumServer.lua in sider.ini

3. Not always accurate stadium selection during saved replays playback [v1.3] - saved replay files do not store tournament_id info. If the stadium used in saved replay has been assigned via map_competitions.txt, then it is not possible for stadium server to make accurate re-selection of that particular stadium during replay playback.

Recommended way to re-pack stadiums that are available in .cpk files

Although extracted stadium packs may work without any problems, I'd recommend to use only one stadium per folder in content\stadium-server.

It is recommended to remove any files that are not directly related to stadium (especially common\etc\... files)

How to use:
Unpack the v1.0 archive and copy folders 'content' and 'modules' inside your sider folder. Unpack v1.3 archive and copy/overwrite extracted StadiumServer.lua to sider\modules folder.

Add lua.module = "StadiumServer.lua" near the top of the Extension modules section in sider.ini

Customize map_teams.txt and map_competitions.txt files and add more stadium folders in content\stadium-server folder

Please, read carefully all the comments inside map_teams.txt and map_competitions.txt files! Always use leading zeroes when writing stadium ID's!

Пример прописки в:
...\Pro Evolution Soccer 2017\content\stadium-server\map_teams.txt
1919, 003, Mapei Stadium, Mapei Stadium # Italy
234, 004, Stadio Atleti Azzurri, Stadio Atleti Azzurri # Italy
107, 003, Villa Park, Villa Park # England
378, 017, Turf Moor, Turf Moor # England
179, 044, White Hart Lane, PES LOVER PACK # England
328, 032, Stadio Adriatico, Stadio Adriatico # Italy
124, 010, Stadio Artemio Franchi, Stadio Artemio Franchi # Italy
235, 018, Stadio Carlo Castellani, Stadio Carlo Castellani # Italy
190, 019, Stadio Friuli, Stadio Friuli # Italy
177, 033, Goodison Park, Goodison Park # England
240, 035, Stadio Luigi Ferraris Genova, Stadio Luigi Ferraris Sampdoria # Italy
323, 037, Stadio Luigi Ferraris Genova, Stadio Luigi Ferraris Genoa # Italy
188, 003, Stadio Marc'Antonio Bentegodi, Stadio Marc Antonio Bentegodi # Italy
122, 006, Stadio Olimpico Roma, Sila pack # Italy

В программу уже добавлены стадионы для примера, находятся тут:

...\Pro Evolution Soccer 2017\content\stadium-server

Установка программы:

Файkы из папки Pro Evolution Soccer 2017, копировать в директорию игры.
Стадионы из Stadium Server не затрагивают стадионы из любого пакета.

Credits:

@juce and @nesa24 for sider

Stadium master-pieces used in this demo-release: @Yucel11 "Fenerbachce Ülker Stadium" and "Türk Telekom Arena"