Skip to main content Link Search Menu Expand Document (external link)

World items

are items that the player can pick up by triggering their hitbox

Table of contents

  1. Adding a world item on a screen
  2. Changing/removing a world item from a screen
  3. Customize a world item
  4. Steps (without Worldsmith)
  5. Next up

Adding a world item on a screen

  1. Navigate to the Screens page.
  2. Right-click onto the canvas on the left side of your screen (where you have your level preview) and select Add on screen…, then Worlditem.

    Worlditem right click

  3. Once clicked, a prompt will ask you to select the Worlditem that you want to add onto the current screen.

    Worlditem details

  4. Once selected, click Add.
    Your Worlditem should appear on your preview.

    Worlditem added successfully

Changing/removing a world item from a screen

  1. Navigate to the Screens page.
  2. Using the Go to screen… button or the up-down arrows, move to the screen you have the background you want to change/get rid of.
  3. From the right side of the page, expand the World items tab.

    Click on a world item or, using the left side of the page (preview), click on the world item’s sprite to easily find the world item you are looking for!

    Props

Modify the world items’s position using the input boxes, or flip the prop’s texture. Click on the red button with the X to remove the world item instance from the current screen.

Customize a world item

  1. Navigate to the Wardrobe page.
  2. Scroll until you find an header “Worlditems”.
  3. Expand both the Customized and the Default tabs to find your world item.
  4. Once found, hover on its name/sprite to show up further settings:

    Hover on worlditem

  5. Click on Replace. A prompt will show up asking you to select the new worlditem’s texture.

    Replace worlditem texture

  6. After clicking Open, your worlditem should have changed sprite!

    Successfully changed worlditem

Steps (without Worldsmith)

Adding a world item

  1. Make sure the item you want to use can be a world item.
  2. Choose where you would like to have the world item in-game, writing down the screen number, X and Y positions.

    Worlditem before

  3. Open the worlditems xml configuration file located in props/worlditems.
  4. Copy the snippet below:
         <WorldItemState>
             <item>YOUR_ITEM_NAME</item>
             <screen>YOUR_WORLDITEM_SCREEN</screen>
             <_x>YOUR_WORLDITEM_X_POSITION</_x>
             <_y>YOUR_WORLDITEM_Y_POSITION</_y>
         </WorldItemState>
    
  5. Paste it below the closing tag of an already existing WorldItemState or below the items tag.
  6. Replace YOUR_ITEM_NAME with the Item name in the item’s list.
  7. Replace YOUR_WORLDITEM_SCREEN with the screen of your choice.
  8. Replace YOUR_WORLDITEM_X_POSITION and YOUR_WORLDITEM_Y_POSITION with their own respective relative value.

The world item should be now available like so:

Worlditem after

In the following example, the item name is Silver. Here’s a preview of my silver’s count before collecting the item:

Inventory before

After interacting with it, the item will disappear from the world and it should:

  • spawn a Silver coin in your inventory if you didn’t have one beforehand
  • add one Silver coin to the Silver coin count

Inventory after

If the item wouldn’t it be stackable and you already had an item present in the inventory, nothing will change in the inventory.

Removing a world item

  1. Open the worlditems xml configuration file located in props/worlditems.
  2. Find the item you want to delete.
  3. Remove the entire WorldItemState tag of the world item that you don’t like.

Personalizing a world item (optional)

In the same folders where you found the worlditems xml configuration file you can find some packed XNB files. Each file corresponds to the texture of the world item.

By replacing any of these, you will change the look of your world item.

FilenameItem
bug_noteBug’s note
capCap
ghost_fragmentGhost Fragment
gnome_hatPhilosopher’s Hat
shoes_ironGiant Boots
shroomMushroom
silver_coinSilver Coin
tunicTunic
yellow_shoesYellow shoes

Next up

NPCs.