Icon Randomizer API

hiimjasmine00

Icon Randomizer API

A mod that provides an API for randomizing icons and colors.

Usage

To use this API, you must first add the following dependency to your mod.json file:

{
    "dependencies": {
        "hiimjustin000.icon_randomizer_api": ">=v3.0.0"
    }
}

Then, you can use the API. For example:

// Include the API
#include 

using namespace geode::prelude;

// Initialize the randomizer
IconRandomizer::init();

// Randomize an icon or color
IconRandomizer::randomize(RandomizeType::Cube);
IconRandomizer::randomize(RandomizeType::Color1);

// Randomize all of a certain type
IconRandomizer::randomizeAll(RandomizeAllType::Icons);
IconRandomizer::randomizeAll(RandomizeAllType::Special);
IconRandomizer::randomizeAll(RandomizeAllType::Colors);

// Refresh unlocked icons and colors
IconRandomizer::init();

// Randomize a separate dual icon or color (Requires the Separate Dual Icons mod by Weebify)
IconRandomizer::randomize(RandomizeType::Cube, true);
IconRandomizer::randomize(RandomizeType::Color1, true);

// Randomize all of a certain type for a separate dual icon or color
IconRandomizer::randomizeAll(RandomizeAllType::Icons, true);
IconRandomizer::randomizeAll(RandomizeAllType::Special, true);
IconRandomizer::randomizeAll(RandomizeAllType::Colors, true);

Full documentation can be found here.

Constants

The following enums are available for use:

enum class RandomizeType {
    Color1 = 0,
    Color2 = 1,
    GlowColor = 2,
    Glow = 3,
    Cube = 4,
    Ship = 5,
    Ball = 6,
    Ufo = 7,
    Wave = 8,
    Robot = 9,
    Spider = 10,
    Swing = 11,
    Jetpack = 12,
    DeathEffect = 13,
    Trail = 14,
    ShipFire = 15,
    Animation = 16,
    Explode = 17
};

enum class RandomizeAllType {
    Icons = 0,
    Special = 1,
    Colors = 2
};

License

This mod is licensed under the MIT License.

Icon Randomizer API Changelog

v3.0.0 (2026-02-06)

  • Ported to Geometry Dash v2.208 / Geode SDK v5.0.0
  • Made RandomizeType and RandomizeAllType scoped enums and moved them to their own header
  • Removed the auto-refreshing functionality from the mod, reverting to the manual refresh method

v2.2.5 (2025-12-07)

  • Updated More Icons support to match the new API

v2.2.4 (2025-10-24)

  • Added auto-refreshing on gold chests and other rewards
  • Added auto-refreshing on account load

v2.2.3 (2025-06-22)

  • Ported to Geode v4.6.1

v2.2.2 (2025-04-02)

  • Added support for iOS

v2.2.1 (2025-03-19)

  • Added auto-refreshing of unlocked icons to the API

v2.2.0 (2025-03-07)

  • Added ICON_RANDOMIZER_API_EXPLODE to RandomizeType
  • Fixed colors randomizing beyond the color limit

v2.1.0 (2025-01-29)

  • Added fromUnlockType and toIconType functions
  • Changed the More Icons support to match the new API

v2.0.0 (2024-11-15)

  • Fixed the semver (I realized that I made a breaking change in a patch version)
  • Ported to Geode v4.0.0-beta.1

v1.1.3-beta.1 (2024-11-13)

  • Removed deprecated API methods due to the game update
  • Renamed a few API methods to replace the deprecated ones
  • Ported to Geometry Dash v2.207

v1.1.2 (2024-10-08)

  • Added More Icons support

v1.1.1 (2024-07-29)

  • Fixed a bug where the randomize all function would not work properly

v1.1.0 (2024-07-14)

  • Replaced the ICON_RANDOMIZER_API constants with enums
  • Recommended the mod "Better Icon Randomizer" by me, because people think this is an actual Icon Randomizer mod

v1.0.1 (2024-07-07)

  • Fixed a bug where exporting the API would not work properly

v1.0.0 (2024-07-07)

  • Initial release

Original Site made by HJfod. Geode 2 parody-ish by MeFinity.

Geode-SDK is the property of the Geode Team.


This website (Geode 2, Codename Malachite) is not affiliated with the Geode Team in any way shape or form.