README.md

TeleporterVR

Easy Utility to allow you to teleport various different ways while being VR compliant. This mod was originally made by Janni9009 for VRCModLoader, I have converted this to MelonLoader for all to enjoy.

MelonLoader

Need to install MelonLoader?
Click this link to get started!

Prerequisites

MelonLoader: v0.5.4+
Game: VRChat build 1207+
Mods:

• UI Expansion Kit
• ActionMenuApi
• ReMod.Core.Updater

MelonPreferences (Default Values)

[TeleporterVR]
preferRightHand = true
VRTeleportVisible = false
overrideLanguage = "off"
ActionMenuApiIntegration = false
EnableTeleportIndicator = true
IndicatorHexColor = "2dff2d"
EnableDesktopTP = false

preferRightHand - Prefer Right Handed (for VR Teleporting)
VRTeleportVisible - VRTeleport Button is visible (next to mute button)
overrideLanguage - force mod into a provided language
ActionMenuApiIntegration - Uses gompo's ActionMenuApi to add options to your Action Menu
EnableTeleportIndicator - Shows a circle to where you will be teleported to when you press your trigger
IndicatorHexColor - Color the Indicator to your liking, in the Hex Color format #rrggbb
EnableDesktopTP - Allows you to teleport to your cursor (desktop only) [KeyBinds = LeftShift + T or Mouse3]

Special Features

Dynamic Language Settings - The language of the mod will be determined by your system's local region, you can override this in the settings of the mod. Changing the language will update in real time (when you close the settings window)
Input (partial) Name - input player's full name or partial name and teleport to them
Coordinates - Input the [X Y Z] coords to teleport to that location
Saved Positions - Save a Position in a world to later teleport to (Load Position) [This does not save across game restarts, but will save across world changes]
VRTeleport - There is a Left/Right Hand toggle to then use your VR Laser Cursor to teleport to that location
Oculus Support - Don't use SteamVR, that's okay, this mod was build for both Native Oculus and SteamVR VRChat use
Languages - This mod uses multiple languages to the mod, you can force a language or let let the mod use your system's language
ActionMenu Control - With gompo's ActionMenuApi mod, you can add the main buttons to your action menu in game

Preview

Credits

Icons

• Font Awesome
• The Noun Project

Language Translations

• French - Slaynash
• German - RequiDev
• Japanese - N/A (Google Translate)
• Norwegian (Bokmål) - Frostbyte
• Russian - Miinc
• Spanish - Myself & Google Translate
• Portuguese - nitro. & Davi
• Swedish - Psychloor

Other Code in the Mod

• Patches - DDAkabono
• emmVRC Risky world / game tag toggling - Psychloor
• Asset Bundle, Keyboard popup input, Enable/Disable Listener - knah
• TeleportIndicator Scripts - Davi (d-mageek)
• ReMod.Core & World Checks - RequiDev

Change Log (since Lily's edits)

v4.12.1

• Desktop Teleport (to cursor) is now properly blocked by RiskyFuncChecks

v4.12.0

• Fix various things in the User Interface (QMBtns)
  • Fixed Language not updating the button's text/tooltip properly
  • Fixed to update RiskyFunc status on ReMenuCategory Title Header
• Updated ReMod.Core references
• Logger method changes
• Major changes to the Language files
• Update general methods
• Removed internal ReMod.Core loading, switched to use Penny's ReMod.Core.Updater

Past Versions

v4.11.2

• Rebuild for fixes

v4.11.1

• Fix an issue where an error would always show, although it was harmless

v4.11.0.1

• Fix ActionMenu menu not updating with RiskyFuncChecks

v4.11.0

• Update Risky Functions
  • Removed emmVRC Network URL checks
  • Worlds that are FriendsOnly, InviteOnly, or InvitePlus will allow risky functions
• Updated ML & Mod references
• Removed UI Expansion Kit menus and integration
• Internal code edits

v4.10.2

• Updated ReMod.Core dependency URL

v4.10.1

• Fixed issues where ReMod.Core was a missing dependency

v4.10.0

• Added option for a menu made with ReMod.Core
• Made ActionMenuApi a Prerequisite Mod

v4.9.2

• Fixed Errors showing when changing worlds if AMApi is disabled or null

v4.9.1

• Revert HttpClient back to WebClient
• Fixed Action Menu always being locked
• Fixed open webpage

v4.9.0

• Changed MelonLogger to MelonLogger.Instance
• Changed World Check Patches to OnJoin/Leave instead of OnFade (Thanks Bono)
• Fixed ActionMenu VRTP Toggle not being consistent to the actual setting

v4.8.1

• Fixed Popup keyboards not showing

v4.8.0

• Added User Selected Teleport button (with UIX)
• Fixed perfered hand option not being updated properly

v4.7.0

• Added VRChat build 1151 compatibility
• Removed RubyButtonAPI

v4.6.0

• Added UIX Menu
• Added VRChat UI Open Beta Detection for less breakage

v4.5.1

• Added UniversalRiskyFunc GameObject Toggle

v4.5.0

• Changed ActionMenu is Open Listener
• Fixed odd behavior when toggling on teleportation

v4.4.2

• Fixed issue where ActionMenu would not close

v4.4.1

• Fixed Compatibility for VRChat Build 1121 (Unity 2019)
• Updated MelonLoader to v0.4.3
• Updated Dependency for ActionMenuApi to v0.3.1

v4.4.0

• Added emmVRC GameObject detection to allow/disallow actions in worlds

v4.3.1

• Security Fixes - Fixed Teleporting not being disabled properly

v4.3.0

• Added Desktop Teleporting to cursor (Disabled by default) [KeyBinds = LeftShift + T or Mouse3]
• Fixed null errors on Controller Raycasts

v4.2.3

• Fixed compatibility for VRChat build 1106
• Fixed various errors regarding the TPIndicator

v4.2.0

• Added a TeleportIndicator, so you know where you're going
• Added Coloring to the Indicator
• Fixed an error about the ActionMenuApi onPrefSaved
• Update ActionMenuApi Dependency

v4.1.1

• Fixed an error that would show when you didn't have ActionMenuApi installed
• Fixed the Left/Right Hand button toggle not changing its state on game start
• preferRightHand is now visible in UIX's MelonPref Viewer

v4.1.0

• Added ActionMenuApi support
• Fixed VR Teleport

v4.0.2

• Updated for VRChat build 1088

v4.0.1

• Updated internal link

v4.0.0

• Initial Release for MelonLoader