![https://lindnerdev.at/assets/banner_3.png](https://lindnerdev.at/assets/banner_3.png) [![https://lindnerdev.at/assets/ios-badge.png](https://lindnerdev.at/assets/ios-badge.png)](https://apps.apple.com/us/app/livekit/id1550358825) [![https://lindnerdev.at/assets/android-badge.png](https://lindnerdev.at/assets/android-badge.png)](https://play.google.com/store/apps/details?id=at.lindnerdev.livekit) ### **What is LiveKit?** LiveKit is more than just a live map that shows what your players are up to. Administrate your server right out of your pocket, manage your world weather, player bans, whitelisting, open inventories, teleport players and much more! Get started with LiveKit with ease and discover all the features we have to offer. This plugin is in active development with new features coming your way regularly! ### Getting started #### Server setup - Download the latest version of the LiveKit plugin -> Move it to your plugins folder - Reload or restart your server - Take note of the console output from LiveKit. It will tell you the **IP** and **Port** you will need to connect through the app! #### App setup - Download LiveKit App from on of the stores mentioned at the top of this page - In the App tap on **+ Connect** and enter the **IP** and **Port** from the step above - Follow the instructions in the App, either connect anonymously, or identify which player you are by using the **/livekit claim** command in-game and entering the code in the app **NOTE:** Port forwarding LiveKit port (default 4123) is !recommended!. Port forwarding allows the App to directly connect to your server. If you don’t setup port forwarding, the connection will be proxied through our proxy service, which will impact connection speed and stability If you are having issues getting started, join our [Discord](https://discord.gg/PUbBDsR5mJ) and ask for help! ### Setting up your world for rendering The map is limited by a predefined boundary, so you control how big your rendered map will be. By default the bounds are rectangular and 1024x1024 blocks (or 64x64 chunks, 2x2 regions) #### Set your bounds /livekit bounds [-r|-c] For example, **/livekit main_world bounds 4096 -c** would set your rendered map border to a circular (-c) shape, with a radius of 4096 blocks #### Start a full render /livekit render full This will start a full render of the world, inside of your bounds defined with the command above. Don’t overdo your bounds, doing a full render takes a while. ### Permissions If you are using a [Vault](https://www.spigotmc.org/resources/vault.34315/) supported Permissions Plugin (for example LuckPerms) set **useVault** option to **true** in the LiveKit config.yml. Make sure to have Vault in your plugins folder. #### Permissions for players

Expand for a list of permissions for players

**livekit.commands.basic**- permission for player commands needed to interact with LiveKit **livekit.module.map** - permission to see the live map **livekit.map.info** - permission to view block info for a specific block **livekit.module.players** - permission to view players on the map (by default you can only see yourself) **livekit.players.other** - permission to see other players than yourself on the map **livekit.module.weathertime** - permission to see current weather and time of the world **livekit.module.chat** - permission to see the chat in the app **livekit.chat.write** - permission to chat from the app (only for identified players) **livekit.chat.write_offline** - permission to chat from the app while not online on the server **livekit.module.poi** - permission to see markers on the map **livekit.poi.personalpins** - permission to set personal pins on the map **livekit.module.messaging** - permission for private messaging through the app

#### Permissions for admins

Expand for a list of permissions for admins

**livekit.commands.admin** - permission for admin commands **livekit.module.admin** - permission for admin actions (ban, whitelist, kick, strike, …) **livekit.module.console** - permission to access server console through the app **livekit.console.execute** - permission to execute console commands **livekit.module.tps** - permission to view the server performance page (CPU, RAM, Ticks) **livekit.module.inventory** - permission to view and edit player inventories

### Commands

Expand for a list of commands

**/livekit** - check if LiveKit is installed and working correctly. Displays basic info for users to connect to LiveKit (port, password needed, anonymous allowed, claim access) and also links to App or Play store **/livekit claim** - generates a pin which is used to identify yourself in the app *[livekit.commands.basic]* **/livekit headrefresh** - refreshes a players head skin *[livekit.commands.basic]* **/livekit pins** - lists players personal set pins and dsiplays their IDs (used for deleting) *[livekit.poi.personalpins]* **/livekit setpin ** - sets a pin at the current location of the player with the provided name *[livekit.poi.personalpin]* **/livekit removepin ** - removes the specified pin *[livekit.poi.personalpin]* **/livekit info** - displays how many active sessions and active clients (Apps) are connected *[livekit.commands.basic]* **/livekit map** - displays information about the current livemap world and rendering status *[livekit.commands.admin]* **/livekit map cpu ** - specifies how much time (in %) a chunk may use up for rendering. If you are doing a full rendering of the world, this can improve the rendering speed BUT, it will also cause server lag! *[livekit.commands.admin]* **/livekit ** - Displays live map info of specified world *[livekit.commands.admin]* **/livekit render full [-m|-f]** - Starts a full render of specified world. -f forces already rendered tiles to render again, -m only renders missing tiles. Default is -f if none specified. *example: /livekit world render full -m* *[livekit.commands.admin]* **/livekit render stop** - Stops current rendering job *[livekit.commands.admin]* **/livekit bounds** - Check the current bounds of the world *[livekit.commands.admin]* **/livekit bounds [-r|-c]** - Sets bounds of specified world to the radius. Radius given in blocks! -c sets a circular radius. -r a rectangular radius. Default is -r *example: /livekit world bounds 4096 -c* *[livekit.commands.admin]* **/livekit bounds ** - Sets bounds to given bounding box left (-x), top (-z), right (+x), bottom (+z). In blocks! *[livekit.commands.admin]* **/livekit headrefresh ** - refreshes a players head skin (5 minute cooldown) *[livekit.commands.admin]*

### Storage Supported storage types are **SQLITE**, **POSTGRESQL** and **MYSQL**. For default storage, **SQLITE** is used and not setup is required #### Migration between storage types

Expand for migration guide

``` #Add the following migrate entry to your Config #This is the currently active storage you want to convert migrate: type: SQLITE sql: host: ‘NULL’ user: ‘NULL’ database: ‘NULL’ password: ‘NULL’ #Change the storage type to your new preferred type storage: type: MYSQL sql: host: ‘localhost’ user: ‘root’ database: ‘LiveKit’ password: ‘asdf23h12h’ ``` The next time you reload or start your server, LiveKit will convert the storage from migrate -> storage. After successful conversion, the migrate entry is removed. Backup your data before migrating! Storage migration will only happen, if the target storage is empty!

### Support Join our LiveKit community on [Discord](https://discord.gg/PUbBDsR5mJ), where you can ask for help, recommend features or just chat with us! ### Plugin integrations #### [EssentialsX](https://www.spigotmc.org/resources/essentialsx.9089/) (Recommended) We’ve added integrations for EssentialsX displaying world spawns (per group), player homes and server warps on the map. Private messaging via /pm /msg will deliver private messages in the app, private app messages will be delivered in-game via Essentials private messaging ##### Permissions

Expand for a list of permissions

**livekit.essentials.info** - displays EssentialsX player info on the player info panel **livekit.essentials.homes** - displays player homes on map **livekit.essentials.warps** - displays warps on the map **livekit.essentials.spawn** - displays spawns on the map **livekit.essentials.admin** - displays admin info (god mode, jailed, muted…) on player info panel

#### [DiscrodSRV](https://www.spigotmc.org/resources/discordsrv.18494/) Displays chat messages from selected channels in the app ##### Config

Expand for config

``` plugins: DiscordSRV: enabled: true channelIDs: - ‘859524672889552926’ ``` Make sure to quote the channel ID ‘859…926’

### Data Privacy With LiveKit v1.4.6 and moving forward, the LiveKit plugin communicates with our backend, communicating different metrics so we can provide a better service. LiveKit also offers proxied connections which are provided through our backend. At the moment the following data is collected and stored: - Minecraft Server IP, Minecraft Port, LiveKit Port - LiveKit connection attempts You can ask us to delete data corresponding to your server at any time on our [Discord](https://discord.gg/PUbBDsR5mJ). Data will never be shared and only exists to create a better experience for you!

xStachelbaer

xStachelbaer's Plugins

LiveKit by xStachelbaer

xStachelbaer's Organizations

Stars

Watching

LiveKit by