Subscribe to download
Logic Block Card Reader

This mod adds a Logic Block with some basic scripting functionality to the game, with an LCD SCreen

Place this on a grid you plan on using for an event, or a spawner. You can use a simple in-game script to determine what the card reader does, and with what item to do it with!
By default, any item that is successfully used, is destroyed upon use.

For example: You have a ground installation, and a front door. If the players can find a Security Card somewhere in the world (they aren't craftable by default), they could insert the card and automatically open up doors you designate.

A Higher Level Security card might open ALL doors, and possibly even disable turrets for a preset amount of time.

Included in this mod is a Card Reader, a Card Model, and preset Cards you can use out of the box. Their subtypes are in Brackets:

Blank (BlankKeycard)
Sliced(SlicedKeycard)
T1 (KeycardT1)
T2 (KeycardT2)
T3 (KeycardT3)
T4 (KeycardT4)
Note: ANY item can be accepted, so if you want to allow someone to jam a small pipe into it to cause an assembler to stop working, you can! Just put in the subtype ID of the component.

All have icons, and the card reader can only be built by an admin.


To use the logic, you add it to the "Custom Data" field of the Card Reader, and then Enable/Disable the block (no need to reload anymore)

In a nutshell, the logic is as follows:
Component: Action Variables (1 or many) SEMICOLON;
<ComponentSubtypeId>(Optional:+), <actionType>|<variable1>|<variable(n)>;

To have a card open a single door named "Front Door", and you wanted it to use the T1 keycard that would be destroyed on use, you would:

KeycardT1,open|Front Door;

When the user puts in the keycard, the door will open.

If you DON'T want the Keycard to be destroyed on use, you would add a + to it, like so:
KeycardT1+,open|Front Door;

Say the user has a sliced keycard...you could set up a timer block that turns on a trap after 5 seconds, so you would do:

SlicedKeycard,open|Front Door,runTimer|TimerBlock1;

As you can see, you can have multiple actions on the same line if you want one card to do the same thing.
You could have ALSO done it like so:

SlicedKeycard,open|Front Door;
SlicedKeycard,runTimer|TimerBlock1;

Both would result in the same outcome. It runs all commands at the same time, so order doesn't matter.
If a variable is optional, leave it out. If

Actions Variables Effect

open Door Name Opens a door
runTimer Timer Name|OffsetInSeconds Runs a timer, optional offset in Seconds
runNow Timer Name Run the timer now
disableGroup groupname Disables all functional blocks in a group
enableGroup groupname Enables all functional blocks in a group
SpawnBlackSpider No other variables. Just...spawn a spider that'll attack people

MES Spawner is a bit more complicated:
MESSpawnPrefab GPSOffset|TypeOfPrefab|PrefabGroup(n)...

GPS Offset is in the format {X:0~Y:0~Z:0}. Tidles between EACH XYZ variable. Don't forget to enclose it in Curly Braces {}.
TypeOfPrefab must be filled out correctly:
PrefabGroup is the encounter you want it to spawn.

PCS for Planetary Cargo Ships
PI for Planetary Installations
SCS for Space Cargo Ships
BE for Boss Encounters
RE for Random Encounters.

Note: You *can* attempt to spawn multiple spawn groups IF they are of the same TypeofPrefab, by adding them to the end of the command like so:

MESSpawnPrefab,{X:0~Y:0~Z:150}PI|BaseEncounter|BaseEncounter2|BaseEncounter3|BaseEncounter(n)....;

MES will then randomly pick one of the encounters you entered. If you try to enter a group that is not the correct type, nothing bad will happen it just most likely won't appear.

MES still does it's spawn checks, and if no valid area is not found, or can't spawn a grid due to settings, it won't appear.

If something is not spawning properly, first ensure MES is not failing to do the spawn by checking the log files, located on the MES Wiki.



Update Dec 22 @23:20


Come join me and other amazing mod authors on Discord:

https://discord.gg/G4Qjtfkc7B

That's usually the best place to ask questions about this mod, or submit a bug report!

If you wish to make your OWN model for the card reader, or add new 'card' types, go ahead! It just needs to be a cargo container, and have the subtype CardReader *somewhere* in its name.


You may not, however, reupload this mod without my permission (just ask first, I'm usually OK with it!)


If you're interested in supporting my work, I would ask for donations to: https://www.hospicecareottawa.ca/