Mage Flag Importer Mod

This BepInEx mod enhances the creative experience in Mage Arena by allowing players to import custom images and convert them into pixel art flags. The mod provides an intuitive file browser interface and handles all the image processing automatically, and adds 10 presets to save and load from.

Features

• Image Import: Import any BMP, JPG, JPEG, or PNG image file through a native file browser
• Automatic Conversion: Automatically converts images to pixel art using the game's color palette
• Presets: Load and save to 10 different presets.

Installation

1. Prerequisites:

   • Ensure you have BepInEx installed for Mage Arena

2. Installation:

   MageArena/
   └── BepInEx/
       └── plugins/
           ├── MageFlagImporter.dll
   

3. Usage:

   • In-lobby, After the game starts press "Edit Team Flag" then "Load from image file"
   • Select your image file and watch it convert to a pixel art flag
   • The flag will automatically sync with other players

4. Sharing:

   If you would like to share your creations you can upload or download the config file.

   MageArena/
   └── BepInEx/
       └── config/
           ├── com.d1gq.mage.flag.importer.cfg
   

Technical Details

• Image Processing:

  • Uses optimized color matching algorithms
  • Processes images in batches to maintain game performance
  • Handles texture scaling and palette conversion automatically

• Network Compatibility:

  • Fully synchronized using FishNet networking
  • Works in both hosted and client modes

• Preset:

  • With the presets enabled, get 10 different presets to use, which save to com.d1gq.mage.flag.importer.cfg
  • The preset modification can also be disabled in com.d1gq.mage.flag.importer.cfg if it conflicts with other mods!

Changelog

v1.5.0

• Added MageConfigurationAPI dependency to make it simpler to modify configurations

v1.4.0

• Added configuration to sync flag by individual pixels, due to issues with system language on ServerLoadFlag rpc.
• Fixed exception when trying to load a file on the sorcerer team.

v1.3.0

• Added configuration to disable preset modification, in cases of conflicting with other mods.
• Capped preset configuration.

v1.2.0

• Added 10 different presets to change from, allowing to save multiple flags!

v1.1.0

• Main thread is no longer being used for File Explorer, which caused the game to temporarily freeze.
• Optimize image loading logic, Image loads 10x faster now!

v1.0.0

• Initial release with basic image import functionality.
• Progressive rendering system.
• Network synchronization.