Weak Teleporter
Add the weak teleporter that only teleports players and disallows certain items in inventory.
Description
This is a mod I made for a server. It's useful for multiplayer (or a map scenario/dungeon run, perhaps) where there are many towns so far apart that players can teleport to a certain town without making the other means of transportation (e.g., by boats, elk, or foot) obsolete.
- The weak teleporter will only allow players to be teleported (unlike the vanilla teleporter, which allows all entities). Like the vanilla teleporter, you can select the destination in creative mode + right-click the block. So, 1-way or 2-way teleporting is highly configurable.
- It also checks the player's inventory for banned items similar to the portal in the game Valheim (configurable in AppData\Roaming\VintagestoryData\ModConfig). So players still have to rely on long-distance travel options such as boats, elks to open trade routes between distant towns.
- By default, the "weak teleporter" and the "tuning fork" are not craftable. However, you can change "isCraftable" to true in the ModConfig to enable crafting them.
- The "Tuning Fork" is an item that can be used in Survival Mode to configure the "Weak Teleporter" and SHIFT + RIGHTCLICK any placed "Weak Teleporter" to drop it as an item on the ground.
- To protect your "Weak Teleporter" in multiplayer from being reconfigured, make sure that you claim the area!!!
<span style="text-decoration: underline;">Other Mods Compatibility:</span>
Carry On Mod: Players that have a carried-on block (chest, reed chest, .etc) with them will not be able to be teleported with the Weak Teleporter
This mod features an extensive way to ban items in the ModConfig. Check the guide below.
Guide On Configuration
There are 3 main ways you can ban an item
1. Ban a specific item
You can write an item code in string format, such as "flaxtwine" like this:
<pre style="background-color: #1a365d; color: #e2e8f0; padding: 12px; border-radius: 4px; overflow-x: auto; margin: 8px 0; border-left: 4px solid #4299e1;"><span style="color: #e2e8f0;"> "BannedItemCodes": [ "flaxtwine" ],</span></pre> You can search for item codes in this wiki: https://wiki.vintagestory.at/Special:MyLanguage/Item_codes
Or you can turn on Developer Mode and see the item codes in-game: Settings -> Interfaces -> Developer Mode
2. Ban a group of items using wildcard
Notice that in the vanilla version, item codes (like above) are written with an organized prefix (or suffix). For example :
- fish-raw
- fish-cooked
- fish-cured
Therefore, you can use wildcards to ban anything starting with fish:
<pre style="background-color: #1a365d; color: #e2e8f0; padding: 12px; border-radius: 4px; overflow-x: auto; margin: 8px 0; border-left: 4px solid #4299e1;"><span style="color: #e2e8f0;"> "BannedItemWildcards": [ "fish-", ],</span></pre> ending with fish:
<pre style="background-color: #1a365d; color: #e2e8f0; padding: 12px; border-radius: 4px; overflow-x: auto; margin: 8px 0; border-left: 4px solid #4299e1;"><span style="color: #e2e8f0;"> "BannedItemWildcards": [ "fish", ],</span></pre> or has a "fish" string somewhere in the middle of the item codes:
<pre style="background-color: #1a365d; color: #e2e8f0; padding: 12px; border-radius: 4px; overflow-x: auto; margin: 8px 0; border-left: 4px solid #4299e1;"><span style="color: #e2e8f0;"> "BannedItemWildcards": [ "fish", ],</span></pre> The last example above, "fish*", should normally be avoided, because you are banning everything that has the word "fish" but might not be related, e.g., "fish-trap", "clothing-fisherman", "fishscale".
3. Lastly, you can ban a certain class of the items
I imagine that not ALL modders follow the convention of item code naming as in vanilla, so if you have a bunch of mods installed and are not sure about the item codes of those installed mods, you have a last powerful option, which is banning the class of items. All items in Vintage Story are inherited from a certain class of code. For example, a poultice has its code written like this:
<pre style="background-color: #1a365d; color: #e2e8f0; padding: 12px; border-radius: 4px; overflow-x: auto; margin: 8px 0; border-left: 4px solid #4299e1;"><span style="color: #e2e8f0;"> public class ItemPoultice : Item, ICanHealCreature </span></pre> Let's say a modder makes a mod that increases the healing effect of poultice or adds many other different types of poultice, chances are they will use "ItemPoultice" class or "ICanHealCreature" class. Therefore, you can ban all poultices using:
Ratings & reviews
Sign in to leave a rating or comment.
