[mod] EmpyrionTeleporter

Discussion in 'Empyrion API' started by ASTIC, Jul 12, 2018.

  1. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    Empyrion Teleporter



    FAQ
    Download:
    https://github.com/GitHub-TC/EmpyrionTeleporter/releases

    Source:
    https://github.com/GitHub-TC/EmpyrionTeleporter

    Wo für ist das?
    Ein Teleport zwischen zwei vorher eingerichteten Positionen. Dabei muss der Spieler zuvor an BEIDEN Orten gewesen sein und dort die Teleporterposition relativ zu einer Struktur festgelegt haben.

    Anleitung zum Einrichten eines virtuellen Teleporters?
    Befehle über die Fraktionstextleiste eingeben (Fraktionschat: entspricht der ; Semikolon oder Kommataste)
    1. Als erstes stelle dich an die Stelle von wo du den ersten Teleporterpunkt setzen möchtest... z.B. in deiner Base. Wie man diesen Platz einrichtet ist völlig egal. Am besten ein LED Pad mit Aufschrift teleport nach xy.... und ihn vielleicht farblich markieren damit man ihn wiederfindet.
      Dann gibst du folgenden Befehl ein: /tt 1234567 7654321 und Entertaste wobei die erste Zahl der ID deiner Basis entspricht und nach einer Leertaste die ID deines Zieles entspricht. Dies kann ein Raumschiff oder eine weitere Basis sein.
      So der erste Telepunkt ist nun gesetzt.
    2. Nun begebe dich zu deinem Zielort. Stelle dort auch ein Display auf und beschrifte es dem entsprechen z.B. Teleport zur Basis…. und auch hier solltest du ihn vielleicht farblich markieren damit man ihn wiederfindet.
      Dann gib folgenden Befehl ein: /tt 7654321 1234567
      Also die ID Nummern in genau umgekehrter Reihenfolge
    Und schon ist der Teleporter fertig eingerichtet und du kannst ihn mit /tt benutzen.
    Viel Spaß beim Teleportieren....

    Hilfe
    Die Kommandos funktionieren NUR im Fraktionschat!
    • /tt help : Zeigt die Kommandos der Mod an

    Teleport
    • /tt => Teleport von dieser (vorher eingerichteten) Position zum Ziel durchführen
    • /tt help => Liste der Kommandos
    • /tt back => Falls ein Teleport schiefgegenen sein sollte kann sich der Spieler hiermit zu der Position VOR dem Teleport zurück teleportieren lassen
    • /tt delete <Id> => Löscht alle Teleporterouten von und nach <Id>
    • /tt list <Id> => Listet alle Teleporterouten von und nach <Id> auf
    • /tt listall => Listet alle Teleporterouten auf (nur ab Moderator erlaubt)
    • /tt cleanup => Löscht alle Teleporterrouten die zu gelöschten Strukturen führen (only Moderators can use it)
    • /tt private <SourceId> <TargetId> => Privaten Teleportort von der aktuellen Spielerposition relativ zur <SourceId> nach <TargetId> einrichten der nur für den Spieler nutzbar ist.
    • /tt faction <SourceId> <TargetId> => Fraktions Teleportort von der aktuellen Spielerposition relativ zur <SourceId> nach <TargetId> einrichten der nur für die Fraktion nutzbar ist.
    • /tt allies => Fraktions/Allierte Teleportort von der aktuellen Spielerposition relativ zur nach einrichten der nur für die Fraktion und deren Allierte nutzbar ist.
    • /tt <SourceId> <TargetId> => Öffentlichen Teleportort von der aktuellen Spielerposition relativ zur <SourceId> nach <TargetId> einrichten.
    Beispiel:
    • Basis: Akua (Id:1001)
    • CV: Akua Orbit (Id:4004)
    1. Auf/Bei der Basis die Position des Spielers markieren (Textur, LCD, Farbe,...) und das Kommando "/tt 1001 4004" aufrufen
    2. Zum CV reisen (noch manuell) ;-)
    3. Auf/Bei/In dem CV die Position des Spielers markieren (Textur, LCD, Farbe,...) und das Kommando "/tt 4004 1001" aufrufen
    => Nun ist eine Teleporterroute eingerichtet und kann von den beiden markierten Positionen aus benutzt werden in dem der Spieler, an der Position stehend, im Fraktionschat den Befehl /tt absetzt.​

    HINWEIS: Da Empyrion es mit den Positionen beim Teleport nicht so genau nimmt sollte der Raum um einen herum ausreichend Platz bieten ;-)

    Konfiguration
    Eine Konfiguration kann man in der Datei (wird beim ersten Start automatisch erstellt)
    [Empyrion Directory]\Saves\Games\[SaveGameName]\Mods\EmpyrionTeleporter\TeleporterDB.xml
    vornehmen.

    • HoldPlayerOnPositionAfterTeleport: Zeit in Sekunden die ein Spieler nach dem Teleport auf Position gehalten wird bis die Strukturen (hoffentlich) nachgeladen sind
    • CostsPerTeleporterPosition: Creditkosten für das Setzen eines Teleporterpunktes
    • CostsPerTeleport: Creditkosten für das Benutzen eines Teleporterpunktes
    • AllowedStructures: Liste der erlaubten Strukturen für Teleporterpunkte hierbei sind folgende Werte erlaubt
      • EntityType: BA, CV, SV, HV
      • FactionGroups: Faction, Player, Alien, Admin
    • ForbiddenPlayfields: Liste der Playfield in oder zu denen kein Teleporten oder Erstellen eines Teleporter erlaubt ist
      • Beispieleintrag: <string>Akua</string>
    Was kommt noch?
    Zunächst erstmal und damit viel Spaß beim Teleportieren wünscht euch
    ASTIC/TC

    Version 1.1:
    • Konfiguration der erlaubten Strukturen möglich
    • Kosten für das Setzen und das Benutzen der Teleporter einstellbar
    Version 1.2:
    • Konfiguration bei Hilfe anzeigen
    • Struktur nut noch von Typ und Fraktionsart abhängig gemacht
    • (BugFix) Konfigurationsverdoppelung korrigiert
    Version 1.3:
    • Spieler für n-Sekunden auf Position halten bis die Strukturen geladen sind
    • ReadMe erweitert
    Version 1.4:
    • Spieler für n-Sekunden auf Position halten bis die Strukturen geladen sind - verbessert
    • Datendatei in das Savegame verschoben (damit es vom Backup des EAH erfasst wird)
    • CleanUp Kommand hinzugefügt
    • Zielkoordinaten besser ermittelt
    • Meldungen für Spieler verbessert
    Version 1.4.2:
    • Ein bisschen Farbe in den Hilfetext gebracht
    • Version der Mod im Hilfetext angezeigt
    • Teleportdelay um den Spieler auf Position zu halten wieder auf 2sec gesetzt
    Version 1.5:
    • Verbotene Playfields sind nun konfigurierbar
    • Ausgabe der Teleporterliste übersichtlicher gemacht
    Version 1.5.2:
    • Löschen einer einzelne Route möglich
    • Zeitmessung bei /tt listall
    • Verbesserte Ausgaben
    Version 1.6:
    • Spieler nach Ablauf der Teleporterzeit nur einmalig erneut an die Zielposition setzen
    Version 1.7:
    • Spieler auf Teleport vorbereiten
    Version 1.8:
    • Spielergesundheit vor und nach dem Teleportieren auf 500 (healthMax) setzen um denn eventuell auftretenden Fallschaden zu kompensieren
    Version 1.9:
    • Fix "delete" Kommando und ReadMe um Anleitung erweitert
    Version 1.9.3:
    • Anpassung an neue Pfadstruktur von Empyrion
    Version 2.0.0:
    • .NET 4.6, allies teleport permission, bandages gift - needs EWA/ModLoader

    English-Version: =============================================

    FAQ
    Download:
    https://github.com/GitHub-TC/EmpyrionTeleporter/releases

    Source:
    https://github.com/GitHub-TC/EmpyrionTeleporter

    What is this?
    A MOD which can be used to teleport players to previously configured positions. It's required that the player must visited the places before and the teleport positions got binded to the structure.

    How to set up a virtual teleporter?
    Enter commands via the fraction text bar (faction chat: corresponds to the semicolon or comma key)
    1. First, take a look at where you want to put the first teleporter point ... e.g. in your base. How to set up this place does not matter. Best an LED pad with inscription teleport to xy .... and maybe mark him in color so that you can find him again.
      Then enter the following command: / tt 1234567 7654321 and enter key where the first number corresponds to the ID of your base and after a space bar corresponds to the ID of your target. This can be a spaceship or another base.
      So the first telepoint is now set.
    2. Now go to your destination. Place a display there as well and label it according to e.g. Teleport to the base .... And here you should also mark it in color so that you will find it again.
      Then enter the following command: / tt 7654321 1234567
      So the ID numbers in exactly the reverse order
    And the teleporter is already set up and you can use it with / tt.
    Have fun teleporting ....

    Help
    All commands only work in faction chat!
    • /tt help : show useful information and commands about the MOD

    Teleport
    • /tt : teleport the player from previously configured position to the destination
    • /tt help : show all commands
    • /tt back : if a teleport failed, the player can get back to the position he came from
    • /tt delete <Id> : removes the teleport connection regarding this ID
    • /tt list <Id> : show all teleport connections from and to this ID
    • /tt listall : show all teleport connections (only Moderators can use it)
    • /tt cleanup : remove all teleport connections to deleted structures (only Moderators can use it)
    • /tt private <SourceId> <TargetId> : set a private teleport location from the player current position relative to the source ID and target ID. Private means only that player can use this teleporter
    • /tt faction <SourceId> <TargetId> : set a faction teleport location from the player current position relative to the source ID and target ID. Faction means all of that faction can use this teleporter
    • /tt allies : set a faction/allies teleport location from the player current position relative to the source ID and target ID. Faction means all of that faction and allies can use this teleporter
    • /tt <SourceId> <TargetId> : public teleporter from current position
    Example:
    • Basis: Akua (Id:1001)
    • CV: Akua Orbit (Id:4004)
    1. Mark on/in the base a teleporter spot and use the command "/tt 1001 4004"
    2. Visit your CV ;-)
    3. Mark on/in the CV a teleporter spot and use the command "/tt 4004 1001"
    => Now a teleporter route is set up and can be used from the two marked positions in which the player, standing at the position, places the command /tt in the fraction chat.​

    HINT: Keep in mind that before you use the teleport commands you need to wait a bit until the Empyrion API registers your player position. Otherwise it is not 100% accurate. ;-)

    Configuration
    You can configure the mod in
    [Empyrion Directory]\Saves\Games\[SaveGameName]\Mods\EmpyrionTeleporter\TeleporterDB.xml
    (will be created with the first start automatically).
    • HoldPlayerOnPositionAfterTeleport: Time in seconds where the player will be hold to the teleport position until the structure is loaded (to prevent gravity fall down for example)
    • CostsPerTeleporterPosition: Set credit cost for creating a teleport connection point
    • CostsPerTeleport: Set credit cost for using the teleporter
    • AllowedStructures: Set the allowed structures player can use the teleporter on/in
      • EntityType: BA, CV, SV, HV
      • FactionGroups: Faction, Player, Alien, Admin
    • ForbiddenPlayfields: List of playfields in or to which no teleporting or teleporter creation is allowed
      • Example entry: <string> Akua </ string>

    Is that it?
    First of all, and so much fun while teleporting wishes you
    ASTIC/TC

    Version 1.1:
    • Configuration of the permitted structures possible
    • Costs for setting and using the Teleporter adjustable

    Version 1.2:
    • Show configuration in Help
    • Structure only dependent on type and fraction type
    • (BugFix) Configuration doubled corrected

    Version 1.3:
    • Keep player in position for n seconds until the structures are loaded
    • ReadMe extended

    Version 1.4:
    • Keep players in position for n seconds until the structures are loaded - improved
    • Data file moved to the savegame (to be captured by the EAH backup)
    • CleanUp command added
    • Target coordinates better determined
    • Messages for players improved
    Version 1.4.2:
    • Put a little color in the help text
    • Version of the mod displayed in the help text
    • Teleportdelay to keep the player in position again set to 2sec

    Version 1.5:
    • Forbidden playfields are now configurable
    • Teleporter list made clearer
    Version 1.5.2:
    • Delete a single route possible
    • Time measurement at / tt listall
    • Improved issues
    Version 1.6:
    • After the teleporter time, players only have to return to the target position once
    Version 1.7:
    • Prepare players for teleport
    Version 1.8:
    • Set player health before and after teleporting to 500 (healthMax) to compensate for eventual fall damage
    Version 1.9:
    • Fix "delete" Command and ReadMe extended with manual
    Version 2.0.0:
    • .NET 4.6, allies teleport permission, bandages gift - needs EWA/ModLoader
     
    #1
    Last edited: May 16, 2019
  2. Kaeser

    Kaeser Rear Admiral

    Joined:
    Aug 17, 2015
    Messages:
    1,640
    Likes Received:
    2,422
    Nice,

    I assume this only works in MP right?
     
    #2
  3. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    Unfortunately, Eleon has switched off the mods for SP installations - the only possibility is to run a dedicated server in parallel on your computer and then to connect to it via MP Connect IP 127.0.0.1

    By the way ... so I develop and test the mods locally on my computer
     
    #3
    Kaeser likes this.
  4. GasBandit

    GasBandit Commander

    Joined:
    Mar 19, 2017
    Messages:
    43
    Likes Received:
    35
    Hey ASTIC, does it work for faction-owned structures, too? I had a user last night trying to create a /tt between two of his factions' structures, and it was telling him that the structure could not handle the object.
     
    #4
  5. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    You can set in the configuration what everything should be allowed. (Note: As of Version 1.4, the file is located at SaveGame directory
    [Empyrion Directory] \ Saves \ Games \ [SaveGameName] \ Mods \ EmpyrionTeleporter \ TeleporterDB.xml)
    A setting, e.g. BA & CV is allowed for players and factions

    <Configuration>
    ...
    <AllowedStructures>
    <AllowedStructure>
    <EntityType>BA</EntityType>
    <FactionGroups>Player</FactionGroups>
    </AllowedStructure>
    <AllowedStructure>
    <EntityType>BA</EntityType>
    <FactionGroups>Faction</FactionGroups>
    </AllowedStructure>
    <AllowedStructure>
    <EntityType>CV</EntityType>
    <FactionGroups>Player</FactionGroups>
    </AllowedStructure>
    <AllowedStructure>
    <EntityType>CV</EntityType>
    <FactionGroups>Faction</FactionGroups>
    </AllowedStructure>
    </AllowedStructures>
    </Configuration>

    See the Configuration section in the documentation above ;-)

    Quote:
    AllowedStructures: Set the allowed structures player can use the teleporter on/in
    • EntityType: BA, CV, SV, HV
    • FactionGroups: Faction, Player, Alien, Admin
     
    #5
  6. GasBandit

    GasBandit Commander

    Joined:
    Mar 19, 2017
    Messages:
    43
    Likes Received:
    35
    Got it, thanks! Guess it just wasn't in there by default. Seems to be working now. Appreciate it!
     
    #6
  7. GasBandit

    GasBandit Commander

    Joined:
    Mar 19, 2017
    Messages:
    43
    Likes Received:
    35
    Contrary to how it is indicated in /tt help, an admin entering /tt delete 123 456 will delete ALL teleports involving both structureID 123 AND 456, not just the one teleporter that goes between them.
     
    #7
  8. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    Right, stupid mistake :-( sorry
    I fixed it in the 1.9
     
    #8
  9. TheStoffie

    TheStoffie Ensign

    Joined:
    Nov 28, 2018
    Messages:
    2
    Likes Received:
    0
    Moin :)

    Ich habe für Testzwecke den Teleporter installiert und wollte sehen, ob man von einem Planeten zu einen Raumschiff (CV) porten kann.
    Auf den Planeten getestet und es funktioniert... :)
    Das Raumschiff in den Orbit gebracht und dann versucht zu teleportieren. Es passierte nichts. Er sagte nur keine Teleportstrecke vorhanden.
    Ich dachte, das geht auch so...? Oder hab ich da was falsch gemacht.

    Mfg Stoffie
     
    #9
  10. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    Die Mods bekommen Veränderungen nur verzögert geliefert, daher musst du mit deinem CV eine weile ruhig stehen, damit die Mod die "echte" Position bekommt und anhand derer dann den "korrekten" Teleporterpunkt ermitteln kann auf dem du dann stehst.
    Also einfach mal eine Minute warten ;-)
     
    #10
  11. TheStoffie

    TheStoffie Ensign

    Joined:
    Nov 28, 2018
    Messages:
    2
    Likes Received:
    0
    Moin :)

    Wir hatte jetzt ca. 5 minuten nach dem Flug gewartet. Leider nichts passiert. Aber nach dem wir uns ausgelogt haben, ging es sofort. Laut Serverkonsole wurde der Orbit unloaded und wieder geladen, bei connecten.

    Kann man die Abfragezeit für den MOD verändern? also für die Positionsdaten z.B.

    Sonst so läuft er ja super - danke :)

    Mfg Stoffie
     
    #11
  12. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    Hmmm ... komisch, habe ich selber auf unserem Server noch nicht gehabt aber vielleicht hat sich an dem "Ladeverhalten" der Playfields was geändert. Die MOD fragt die (aktuellen) Positionsdaten der Strukturen und des Spielers immer erst mit dem Befehl /tt ab ?!?!
    Aber ich schau mal ob ich was finde, denn das mache ich selber eigentlich immer genau so - nur mit dem Unterschied das ich zwischen zwei CVs teleportiere - ein Trägerschiff und ein Transport/Arbeits CV
     
    #12
  13. GasBandit

    GasBandit Commander

    Joined:
    Mar 19, 2017
    Messages:
    43
    Likes Received:
    35
    Hey ASTIC, one of my users had a feature request. They'd like to be able to set up a teleporter that allies of their faction can use as well. I don't know if that's possible, per se, but I thought I'd pass it along.
     
    #13
  14. ASTIC

    ASTIC Rear Admiral

    Joined:
    Dec 11, 2016
    Messages:
    1,091
    Likes Received:
    732
    Good idea.

    I'm just about to change my mods to .NET 4.6 and to use the new configuration options of the EWA.
    I will also implement the alliance permission with that new release.
     
    #14

Share This Page