Mod Guidelines

These are the guidelines for mods published on the mods index. All mods on the index are required to follow these rules.

It is the responsibility of both the mod developer and the person who verifies the mod to make sure the mod abides by the rules. If a mod is mistakingly approved, or it receives an update the breaks the rules, they may be applied retroactively.

Ban rules

A mod found breaking any of these rules will be rejected unconditionally from the index, as well as very likely leading to a total and permanent ban from posting on the index and a removal of all existing mods on the index.

• The mod contains malware. This means any code with the purpose of causing harm to someone or something
• The mod collects user data without consent. Collecting data locally for the purpose of statistics is fine, but all sort of online data collection must be unambiguously explicit and able to be opted out of.
• The mod is stolen. This means that it consists fully or nearly fully of the original code of another person with credit explicitly erased

Please note that a mod purposefully altering the experience of specific users (such as making gameplay unplayable) and mods harrassing specific people and/or their work is considered malware, regardless of the users in question, unless those users have personally consented to it. This specific form of malware is unlikely to lead to an index-wide ban and will just get the mod delisted, though that depends on the gravity of the situation.

Other rules

ℹ️ As a TL;DR; the rule of thumb for whether something is allowed on the index is compatability. If the mod is or might be incompatible with other mods that it should be compatible with, that is usually grounds for a rejection.

Repeated attemptation of breaking these rules can result in an index-wide ban. Try to make sure that your mod abides by the guidelines. You can contact the index staff if you have any questions about your specific case.

A mod found breaking any of these rules will be rejected unconditionally from the index.

• The mod contains false information about what it does
• The mod does not use Geode’s provided systems for hooking and patching, resulting in almost guaranteed mod incompatability
• The mod introduces severe security vulnerabilities like RCE
• The mod features explicit content and/or profanity. Note that the source code having comments, variable names, etc. containing profanity is fine, as long as they aren’t visible to the end user
• The mod does not have appropriate metadata. All mods on the Index must have a proper name, description, icon, and tags, including jokes
• The mod removes Vanilla features for no good reason
• The mod installs other mods from outside the Geode index. You are not allowed to run any arbitary code downloaded off the internet. There are two exceptions to this rule: mods that introduce some sort of scripting system that runs sandboxed arbitary code, and mods installing additional paid features as a runtime library. Do note that for the purposes of verification, the code for all of those paid features must be included, including the code used to load them.

A mod found breaking any of these rules will likely be rejected, although depending on the situation, they could also still be approved.

• The mod breaks other mods for no good reason
• The mod has several common game-breaking bugs that haven’t been fixed despite reports
• The mod doesn’t do anything meaningful. Note that joke mods can be considered meaningful; see our policy on them

A mod found breaking any of these rules will likely still be approved, although constant and/or prolific breaking can result in a rejection.

• The mod has several common bugs
• The mod can’t preserve state between bootups (save data, load data) normally
• The mod’s codebase is really hard to read. The reason this might result in a rejection is if the people verifying the mod for the index are unable to properly ascertain if the mod breaks any of the other rules due to the (hopefully unintended) obfuscation

Non-rules

These are some things one might expect to result in a rejection, but actually most likely won’t.

• The mod is logically incompatible with another mod on the index (for example, two mods that completely reshape MenuLayer in different ways are never going to be compatible)
• The mod looks bad. We won’t shame you for not having HJfod’s UI skills! However, if the mod’s UI/UX is not just bad but actively harmful, it probably violates the “no false information” rule
• The mod is not in English. That’s just cool! It might take us a while to verify a mod whose source code is written in another language though

There are also some code patterns that one might assume would be rejected, but are actually allowed:

#ifdef GEODE_IS_WINDOWS
auto editorUIGridSize = reinterpret_cast<float*>(reinterpret_cast<uintptr_t>(EditorUI::get()) + 0x1d0);
#endif

Accessing & modifying members by their raw platform offset is totally okay, as this does not pose any interoperability concerns with other mods, it just makes your mod harder to port.

if (this->querySelector("hjfod.gdshare/export-button")) {
    // GDShare is loaded, compatability code
}

Checking that another mod is loaded by looking for identifying effects of them in the game is completely fine, as long as the checks are safe and don’t make assumptions about things that haven’t been checked. For example, just doing Loader::get()->isModLoaded("hjfod.gdshare") is NOT enough to guarantee all of GDShare’s buttons exist, so you should always check for the buttons themselves!

Mods modifying the Geode UI

Some mods may want to extend Geode’s own UI, for example to add custom features to their own mod’s page. This is allowed, however with some caveats. See the tutorial page for more.

Joke mods

Joke mods, as in mods whose whole function is to just be a funny little goof and nothing else, are allowed, as long as they have a proper name, description, icon, and tags, particularly the Joke tag.

However, do note that for a mod to be listed on the Index it has to be meaningful. That is, it needs to be something that people might actually want to have and use. The precise definition is up to whoever is approving the mod, but in general if a mod is something you would install once for five minutes then uninstall and never use again, it’s probably not meaningful. This mostly includes mods that actively make playing the game worse without adding new kinds of fun, but it can also include visual tweaks so small and unintrusive you forget you even have it installed.

For example:

• A mod that just changes the title of the game to Geometry Fart and nothing else is probably not enough to be accepted
• A mod that deliberately crashes the game on every death is very unlikely to be accepted, as that is something which is funny for one YouTube video but so actively harmful no one would use it normally
• A mod that changes physics to super weird ones might be enough to be accepted, as while most users won’t have it permanently enabled, they may enable it every now and then to use together with other mods like Globed
• A mod that turns the player icon into a badly drawn Sonic the Hedgehog is probably enough to be accepted
• A mod that is a compilation of multiple different toggleable small jokes is absolutely enough to be accepted, provided it doesn’t break any other rules

Paid mods

Paid mods, aka mods that require payment to be used, are allowed on the index as long as they have the Paid tag. Do however note that Geode does not handle any payments - you will need to set up all of the payment infrastructure, DRM, etc. by yourself.

Mods that are usable for free but have extra integrated paid features, such as a Pro version or a Supporter tier, do not need to include the Paid tag unless the paid features are essential to the functioning of the mod. For example, a multiplayer mod that has a paid tier for private rooms but free public rooms for everyone would likely not need the tag.

It is also okay to publish an installer mod for a paid mod on the index, aka something that just asks the user to authenticate and then installs the paid content. These mods also need to have the Paid tag.

Mods using Generative AI

Due to controversy among developers regarding the subject, mods that utilize Generative AI have to follow these additional guidelines in relation to their AI usage.

ℹ️ TL;DR; All mods using AI must be trained on consentually obtained data, and may not be used for creating levels.

• The mod may not grant an unfair advantage in gameplay or anything else to people through the use of AI
• The mod may not compromise the integrity of user-created content. In essence, this means that no mod is allowed to use AI for placing, modifying, or deleting objects, though it is not limited to just those.
• The AI model is only, and as provably as one can reasonably expect, trained on consentually and transparently obtained data. Any mod found to be breaking this rule would be found to be in violation of the “collecting user data without consent” hard-ban rule, and subsequently result in the developer being immediately and permanently banned from the index
• The mod must visibly and unambiguously communicate to the user its use of AI prior to them clicking on it. This can be as simple as adding “AI” or “GPT” to the name of the mod.

In addition, all mods utilizing AI must be manually verified on the index and approved unilaterally by Geode lead developers, regardless of whether the developer is verified on the index or not.

Hateful conduct

Developers may be banned off the mods index and other Geode-related online spaces such as the Discord server and the GitHub organization, if they have committed acts in or outside the Geode community that are considered hateful, harmful, or otherwise detestable. These include, but are not limited to:

• Stealing or defacing other people’s works
• Engaging in indecent activity with minors
• Racism, homophobia, transphobia, or any other form of bigotry
• Any form of public harrassment

This ruling is in place to ensure that Geode stays a safe and welcoming place for everyone. This is a mod loader for a children’s video game - we do not want to indirectly publicize mean people or their actions with it!

Do take note that the list above is not comprehensive nor set in stone, and what qualifies as hateful conduct may and will change and mold over time, with the final say always being left to the Geode team of that time.

Do also note that these rules may very well be enforced retroactively. While we do believe in and hope for people to grow to be better, any person ruled to have committed hateful conduct in the past must give reason for the Geode Team to believe they actually have changed to overturn the verdict.

The “Too Big to Ignore” Rule

Like everything else in this world, the Geode index also does have one set of rules for the ultra rich and another for the rest. Although this is undesirable and we try our best to be fair and equal, some mods are officially considered “too big to ignore” and may be granted small exceptions to index rules that other mods would have to follow. Do note that we do still of course have hard limits; even a mod that is too big to ignore can’t go around stealing user data. In addition, “too big to ignore” status also usually just naturally brings with it responsibility for the mod developer to do good; a big mod being caught stealing user data would result in massive outrage immediately. So, for this reason, mods that are too big to ignore may be granted exceptions in some rules, such as not requiring source code to be submitted.