v21.1 Level Sync + Multi Select Menu Options 1.0.0

Intro:​

Version Info​

• fixed a bug with the options menu that displayed a popup when the game double saved your data (which was also fixed)
• added a metadata file so you can edit my configuration options without hard-coding them and having to reintegrate them every I time I update the plugin
• added in a Badge Count Level Sync Mode that will sync your pokemon's level caps to the amount of badges you have. The caps are configured in the new metadata file ! :)
• I added a python app that will recolor the sprite icons (since the numbers in the databox are spites and the sync icons are also sprites not rendered text) more documentation will be coming ...after I cure my pokopia addiction
• put all my UI code apart from the settings menu into a new rb file, LSUI.rb

• Fixed stability issues for entire project
• Added mega evolution stat handling and EXP capping
• A sync icon will appear on level synced pokemons’ ui: In-battle DataBox, summary screen, pokemon party ui box
• Text will turn yellow when affected by the summary screen. If you don’t like that color, the color’s RGB is saved in the file LSSettings under @LSTextColor.
• Level sync applies to the entire party
• Level sync animation is there upon battle start (can be altered to fit your game’s specific narrative/context. You can edit the message text in LSSettings under the variable @LSBattleMessage ||= _INTL("Level Sync is now in effect!"). Simply change the text inside the orange double quotes.
• Sample event script code has been added to the file EventInfo.txt
• Added a BOATLOAD of configurable debug messages; if you don’t want them printing to your terminal then comment them out with a # symbol at the beginning of the line.
• RANDOM mode changed to choose only 1 pokemon on the enemy side to set level sync caps. I can readd the previous iteration of RANDOM mode should we need
• Mega Evolution stat handling:
  • Mega evolved pokemon will break the base stat sync cap only by increase in their respective stats. For instance, Charizard gains 46 points in its attack stats upon mega evolving into Mega Charizard X. If Charizard's attack was synced to 70 pre-mega, Charizard-X's base attack will be 116
• Bug with HP handling when not at full; HP now resets to the same ratio, rounded down to prevent overhealing or over punishment.
  • On developer demand I can do "set your hp to whatever it was post-sync"

• LS Settings Menu item ordering updated
• Separated Map lists so that the game can store independent level syncing map lists for wild battles and for trainer battles

Level Syncing Features​

Primary Plugin Features + Usage Guide​

About 14 different settings for the game to selectively level sync battles

Click to expand...

• Level Sync -> On/Off
  • Enables/Disables level syncing entirely
• Global Level Sync -> Every Battle will be level synced
  • If Off, then it will ask you to choose between syncing trainer battles or wild battles)
• Synced Stats
  • You can customize which stats can be synced.
  • If a trainer’s pokemon changes form mid-battle, stats on your pokemon will NOT recalculate based on its new form, e.g. your team will sync to match Korrina’s Lucario NOT Korrina’s Mega Lucario.
    • “Level”
      • Syncs to a specified level cap based on the mode chosen
    • “IVs”
      • Syncs to a specified IV value cap based on the mode chosen
    • “EVs”
      • Syncs to a specified EV value cap based on the mode chosen
    • “BaseStats”
      • Syncs to a specified Base Stat value cap based on the mode chosen.
      • Game Design note: My recommendation for this to be off unless you want your players in for a huge challenge.
    • “BP” -> Syncs to a specified move Base Power value cap based on the mode chosen
      • Moves with 0 BP (status moves) are unaffected.
      • Game Design note: This can bring in unique strategies but can be frustrating for players who are used to spamming High BP moves to cheese their way through challenges.
    • “Experience”
      • Will toggle EXP based on either their current level or synced level. Synced level 100 pokemon will still not receive EXP.
      • Game Design note: Nuzlockers tend to be frustrated with the newer games’ EXP share system, so this could be a viable way to deal with this frustration
• Wild Battle Global (On, Off)
  • If enabled, all wild battles will be level synced, if off you can customize which battles will be synced by the following options that’ll appear.
  • Essentials v21.1 categorizes Fateful Encounters as wild battles, so all settings pertaining to wild battles also apply here.
• Wild Battle Mode (Encounters, Maps)
  • If “encounters,” all pokemon of a specified encounter type will be synced (and it doesn’t matter where it happens)
    • Game Design Note: You can make copies of these encounters if you want the same encounter but with different behavior
  • If “maps” you will specify which map(s) you want all wild battles to be synced on.
    • Game Design Note: You may want to tuck in a warning message to the player to tell them if their pokemon will be synced upon entering an area. The safari zone could be a cool example of a situation that might need level synced wild battles!
• Trainer Battle Global
  • If enabled all trainer battles will be level synced; if off, you can customize which battles will be synced by the following options that’ll appear
• Trainer Battle Mode (Classes, Maps)
  • If “classes” all trainers of that trainer type class will be synced.
    • Game Design notes: e.g. all gym leaders, champion, Elite 4, rocket bosses, etc. It may be overkill to sync random map trainers but that’s up to you!
  • If “maps” all trainers of that map will be synced.
    • Game Design notes: battle frontier, gyms, victory road, indigo plateau are all great examples of possible use cases
• Level Sync Mode
  • Default: Max.
  • If “Max” every time a battle is started on the opposing side, the program will find the pokemon in their roster with the highest value in all of the stats specified in “Synced Stats” and will determine the stats from those pokemon. (Example below)
  • If “Min” every time a battle is started on the opposing side, the program will find the pokemon in their roster with the lowest value in all of the stats specified in “Synced Stats” and will determine the stats from those pokemon. (Example below).
    • Due to how varied a pokemon’s stat spread can be this can be extremely punishing to the player if you aren’t careful about the your trainer’s roster
  • If “Random” every time a battle is started on the opposing side, the program will find a random pokemon in their roster for each of the stats specified in “Synced Stats” and will determine the stats from those pokemon. E.g. it will randomly pick a pokemon for each stat. I can adjust this later for future releases.
    • Game Design note: Nuzlockers may not like the stat unpredictability, but if you tune the battles correctly you can make it somewhat more predictable for the player to plan around.
  • If “User Value” is selected you will have the opportunity to fine tune the level caps on the selected substats from the “synced stats” option to whatever encounters/battles you specified
    • Game Design note: This will apply to every synced encounter, so if you have only really specific instances of syncing like at a Battle Frontier facility, or or a Smogon-like battle simulator
  • You cannot choose to mix picking min and maxes of individual stats; it is all MAX, RANDOM, or MIN values.

Known Bugs​

• No code for Max Moves. It may just cap them blindly, or not all, or crash the game.
• No code for Dynamax, but Dynamax and Gigantamax only double base hp which woud be synced prior, meaning it should double the synced base hp value.

• The player’s Mega evolution or form changes’ base stats are not checked to be synced. If the base stats are changed, then the game may have unpredictable stability.
• Experience capping functionality has not been programmed; it is a placeholder setting for now

Essentials Bug Fixes:​

Essentials UI Add-Ons​

Planned Future Version Additions:​

Integration Notes for Other Plugin Developers​

Stat Calculation Order​

• Determine cap values (based on mode)
• Cap Level
• Cap IV
• Cap EV
• Recalculate stats
• Cap battler stats (if BaseStats enabled)
• Cap Move BP
• Apply EXP logic