Add your mod

IsaacGuru's Item Laboratory is a website that supports a variety of popular mods, and has capabilities of storing just about any mod out there!

In order to bring more mods to the website, mod owners can request access to the Admin Panel which enables them to personally (or with a team) maintain their mod - fully customize items, add or remove items, use custom item pools, insert synergies, and much more.

To request your mod to be added, please contact IsaacGuru in the Discord server. Once and if approved, the mod's .xml files will be read and items automatically populated. An admin account will be created with exclusive access to the mod. From there, you can customize each item's attributes.

Newly added mods will remain hidden and available only to people who have access to them until fully checked by IsaacGuru and made public. The check mainly consists of making sure that the Editing Guidelines listed on this page were followed and information was presented in an accurate manner.

Automatization

Most of the item attributes and the items themselves are automatically read from the gamefiles. You don't actually need to manually input things such as name, description, item pools, tags, quality, icons, etc, unless there are specific requirements for some items.

The main manual part revolves around the actual long description of the items.

For example - here is what the Epiphany mod looks like when first read by the website.

The Admin Panel

The Admin Panel can be accessed via the Godhead icon in the sidebar.



Once inside, you will see a few different options, one being the Item Management button that allows you to find and edit any item in your mod.



You can also edit any item directly from the main page, by clicking on the pencil icon in the item's description.



To apply any changes made, use the button. This will instantly push the changes to the database and create a new item description.

The button can be used to refresh the page and cancel all pending changes.

The button will reset any custom modifications to the item and revert it back to its default settings that were read from the .xml files. If this was a custom added item that is not found in the game files, the item will be permanently deleted.

The button can be used to manually add a new item that is not accessible via the game files.

Item attributes

A variety of item attributes can be customized from the Item Management page. Some of these attributes will be locked if the item was read from the game's .xml files because these should always appear as they do in game. This is indicated by a yellow box on top of the page and will lock attributes such as name, description, item type and quality.

Locked attributes (marked in yellow down below) may only be edited for manually added items via the "Add Item" button.

Special Templates

You may find various special template buttons above the item description box. These can be used to insert various game elements such as item icons, pools, tags, as well as perform basic text formatting and some more advanced features.

Some of the buttons will directly insert the element into the description, while others may open up a pop-up window that allows for multiple arguments to be specified before inserting it into the description.



Editing guidelines

In order to maintain consistency around the entire website, please stick to the following guidelines when customizing items:

  1. Make sure to use proper grammar and vocabulary.
  2. Keep sentences short and clean - a shorter description makes for a much better-looking item page and can provide more information when shown via the Discord bot.
  3. No mentioning of lore and trivia - only describe item effects and how they affect gameplay.
  4. No referring to the player as "the player". Always use "Isaac", or if absolutely necessary, "the character".
    Example: "gives 2 hearts to the player" should be "gives 2 hearts to Isaac".
  5. Do not overload the pages with regular synergies - the "Special synergies" section is meant for describing interactions such as Book of Virtues, trinket multipliers and other special items.
  6. Item icons and costumes should be in .webp format - including animated ones! You can use this website to convert animated icons to .webp (mixed format in order to retain quality).
  7. Item icons and costumes should be in their original size as they are in the gamefiles - do not use photo-editing software to upscale pixel art; the website will automatically do this!
  8. Try to keep all item icons with 32x32 dimensions - icons with these exact measurements will be combined into a single spritesheet rather than loading one by one which significantly improves page load times.
  9. When uploading animated item icons, a non-animated icon should be uploaded as well. Failing to do this will display a blank space for users that have disabled animated icons via the Settings page.
  10. Do not use multiple {{i}} tags for the same item - only do this the first time an item is mentioned, and use regular text in the following instances.
    Example: "+1 Black Heart; causes Black Hearts to heal less" - only the first mention (underlined) of Black Hearts should be wrapped around an {{i}} tag. Furthermore, the same capitalization as the original item's name should be used when doing this.
  11. Different sentences should be separated with a double newline (the ^r shortcut). Only use single newlines (^n) when listing multiple stat changes, mentioning multiple items, or other list-style elements.
  12. Always use "fire rate" for items that directly affect fire rate and break the tears cap, and "tears" for a regular tears up that goes up to 5.
  13. If an item has multiple effects that happen upon pickup, while held, or when used, the ^i, ^p and ^a shortcuts should be used to create different sections. For passive items that also grant something upon pickup, there is no need to do this if it's just one line for the pickup - either add both the "On pickup" and "While held" titles, or don't add any at all. For active items, the "On use" title should not be used if there are no other title in the description.
  14. For stat changes, "health" should be used only for items that directly grant Red Heart containers or Broken Hearts. Items that drop any types of hearts on the ground or give temporary health such as Soul/Black Hearts are not to be considered items that affect the health stat.
  15. Stat changes should be the first thing mentioned in the description - positive first, then negative, following the same order as in the HUD, unless otherwise more appropriate.
  16. In order to determine the exact tears/damage up granted by an item, please use the respective {{t}} and {{d}} tags. For example, {{d|5.19}} would output +1 damage.
  17. No duplicate descriptions, e.g. describing other items inside of an item's description. For example, if an item grants Brimstone, the description should not explain how Brimstone works.