Creating Valuables with REPOLib-Sdk #

• Right click in your mod's folder and choose Create > REPOLib > Valuable.
• Fill in the fields:
  • Prefab: a reference to your prefab.
  • Valuable Presets: the valuable presets to register the valuable to. The vanilla values are:
    • Valuables - Generic (applies to every level)
    • Valuables - Wizard
    • Valuables - Manor
    • Valuables - Arctic

Creating a Prefab #

This quickstart will guide you through creating a custom prefab. We'll be making this Among Us valuable, but the steps are largely the same for most valuables:

This guide assumes you have a Unity project set up for REPOLib modding. If not, follow Getting Started first.

The easiest way to get started is to copy a vanilla valuable. If you used the project patcher, they are located in Assets/REPO/Game/Resources/valuables.

We'll choose the Valuable Trophy prefab (under 03 medium) as it's an appropiate size and doesn't have any complex functionality. Let's copy it to our mod's folder and rename it:

Next, we add our model to the prefab. This model can be downloaded here if you want to follow along.

Make sure the model is a child of the Object game object, as seen in the screenshot.

From here, we can center our model and safely delete the old one (called Mesh):

Next, we have to set up the colliders. A valuable consists of one or more Valuable Colliders, which each have these components:

The collider shape (and type of Phys Grab Object Collider) may vary, for example Box or Capsule. For this valuable, we'll keep it simple with only a few box colliders.

Let's delete three of the colliders, so we only have one box left. Then, we resize it to fit the body our Among Us:

Continue with the backpack and visor:

With our model and colliders set up, we can configure the Valuable Object component at the prefab's root:

• Durability Preset: how easily the valuable loses value and breaks.
• Value Preset: how much the valuable is worth, between a min and max.
• Phys Attribute Preset: the mass (weight) of the object.
• Audio Preset: contains the valuable's sound effects for colliding and breaking.
• Audio Preset Pitch: shifts the pitch of the sound effects.
• Particle Colors: the colors of the particles that are created when the object collides. A larger color ratio means particles of that color are more common.
• Volume Type: the size category of the object.

Here are some reasonable values for our Among Us valuable:

The last step is to set our object's bounds in the Room Volume Check component. The easiest way to do this is to import Zehs' custom editor script. Download it here and drag it into Assets.

After that, you should see this button in the inspector:

Click it to automatically align the purple bounds to your colliders.

That's it! Now that you've got a prefab, follow the steps at the top of this page to register the valuable with REPOLib.

Credits #

"Among Us Astronaut - Clay" (https://skfb.ly/6VEEJ) by MatMADNESS is licensed under Creative Commons Attribution (http://creativecommons.org/licenses/by/4.0/).