Gizmos Car Keys (improved)

by Pi-C
Tired of running to your vehicle? Then let it come to you! This mod is based on "Gizmos Car Keys" by aodgizmo. It should work with most modded vehicles (except trains and trains in disguise) -- not just cars.
27 days ago
0.17 - 0.18
1495
Owner: Pi-C
Source: N/A
Homepage: https://forums.factorio.com/viewtopic...
License: MIT
Created: 5 months ago
Latest Version: 0.18.1 (27 days ago)
Factorio version: 0.17 - 0.18
Downloaded: 1495 times

Is your vehicle always where you are not, especially when you need it? Do you regularly waste time running to your vehicle because you need something from its trunk? Then let it come to you instead!

This mod is based on Gizmos Car Keys by aodgizmo. It should work with most modded vehicles (except trains and trains in disguise) -- not just cars.

Usage

After you've researched automobilism (or ships, if Cargo Ships is active), the keys are available. Use them on a vehicle to make it yours. Using them again on the same vehicle will lock/unlock the vehicle. By using them on another vehicle, you give up your previous vehicle and claim the new one. (Hint: If you want to exchange vehicles but are afraid that other players might take something from your vehicle, or the vehicle itself, lock it before you give it up! Only you will be able to claim it in this state.)

If you use the keys on the ground (or on water, if you have a boat) the vehicle will be summoned there -- if it can be placed there, and if that position is within your character's reach. Usually, your reach will be limited during this action to the vanilla game settings (10 tiles) even if you have mods installed that extend your reach. I consider using long reach as extremely cheaty because you can also summon a car if you are in it -- with long reach enabled, your vehicle keys would become your personal mobile teleporter! Nevertheless, if you insist on using the keys with long reach, there should be a startup option hidden somewhere …

In contrast to the original mod, this one also supports vehicle grids and everything else a vehicle might contain. It also is possible to summon vehicles to another surface; driver and player will be teleported along with the vehicle unless they have chosen to be left on the original surface via a per-player runtime setting.

Other than the original mod, this one should be safe to use in multiplayer games.

Does it work with other mods?

Incompatible mods

There have been no reports yet that this mod would cause errors if used together with another mod, so I guess it's safe to use.

Supported mods

Autodrive
- If a vehicle controlled by Autodrive is locked, the dummy passenger will be removed (if present).
- Autodrive now recognizes whether a vehicle has been locked by this mod and will disable its GUI controls in this case.

Cargo Ships
- If this mod is installed, the keys will also be unlocked by researching "Ships".

Remote interface for use by other mods

As of version 0.17.14, other mods can check who has locked a vehicle or who is the owner of a vehicle.

Usage:

  remote.call("GCKI", "vehicle_locked_by", vehicle)
  remote.call("GCKI", "vehicle_owned_by", vehicle)

In both cases, the argument 'vehicle' must be an entity of type "car". Both remote calls will return either a player entity or nil.

Supported languages

  • English
  • German
  • Russian (Dragonling fetches and translates new/changed strings from other mods and includes them in his. I'll eventually integrate his changes, but you'll get new translations faster if you also have his translations-pack mod installed!)

If you can provide a localization for another language, I'd be happy to include it! :-)

Help needed

I've spent quite some time on testing this mod to make sure it's safe to use in multiplayer mode. However, doing these tests locally may not be reliable. So I'm interested in any feedback on issues while playing multiplayer games!

Credits

Credits go to

  • aodgizmo: for the original mod -- I used the code (and changed, added to, or removed parts of it) and the car-key graphics (which I also used for the mod thumbnail) in my mod.
  • Zahnfeechen: for Gizmos Car Keys - Zahnfeechen Patch (which updated aodgizmo's mod for Factorio 0.17) -- I happily played with this mod myself until I decided to make my own version. Because this mod shares a lot of code with mine, it is not only unnecessary to have both active at the same time, it could even lead to unforeseeable results because both mods act on the same events. I therefore decided to let my mod conflict with this one.
  • Dragonling: for the Russian localization -- thanks a lot!