Merge branch 'master' into patch-1

This commit is contained in:
Eric Myllyoja 2021-12-06 11:23:15 -05:00 committed by GitHub
commit dc84c51c6c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 437 additions and 6 deletions

View File

@ -15,9 +15,16 @@ On December 5th, 2021, the Darkflame Universe project released an open-source se
### Server Setup Guides
Curated Guides:
* [Server Setup Guide (Google Cloud)](google-cloud-setup.md)
* [The Mythran's Bible - A Server Operator's Guide to Darkflame Universe](mythrans-bible.md)
Other Guides:
* https://github.com/maxdelayer/DLUQuickstart
* https://gist.github.com/SunFlea/893fd80f39c7cf9ab31baacac284025d
## Community
* [/r/LEGOUniverse on Reddit](https://old.reddit.com/r/legouniverse/)
@ -25,8 +32,13 @@ On December 5th, 2021, the Darkflame Universe project released an open-source se
## Development
* [LU Developer Network](https://lu-dev.net/)
* [DarkflameUniverse on GitHub](https://github.com/DarkflameUniverse)
* [LEGO Universe Technical Documentation](https://docs.lu-dev.net/en/latest/)
- Describes everything known about the inner workings of the game, including the Behavior and Skill systems.
* [LU Explorer tool](https://github.com/Xiphoseer/lu-explorer)
- Allows you to browse the contents of `CDClient.fdb`.
* [LU Developer Network](https://lu-dev.net/)
* [LU Server Projects](https://lusprojects.github.io/)
## Contributions

View File

@ -6,7 +6,7 @@ Now that you've reached this point, there's still a lot to know about managing a
## Port Forwarding
The server you're running will need to open the following ports to allow for outside access to your server:
The server you're running will need to open the following ports to allow for outside access to your server|
* 1001 - Auth Server
* 2000 - Master Server
@ -29,7 +29,7 @@ Players have a max GM level and a current GM level; at any time, a player can us
A player with full GM permissions can lower themselves down to 0 to play the game as though they were a normal player, then raise their level up if they need to do something like teleport or unstuck themselves. Think of it like Minecraft; if you have permissions, you can play the game in Survival, and call `/gamemode creative` only when you get stuck.
There are 10 total levels, as follows:
There are 10 total levels, as follows|
* 0 - Civilian: This level describes all normal players of the game.
- Players at this level still have access some commands, see the Console Commands section below.
@ -40,6 +40,7 @@ There are 10 total levels, as follows:
- Players at this level and above will appear as Mythrans. This cannot be toggled at this time.
* 2 - Junior Moderator: This level describes moderators who can help regulate chat.
- Players at this level and above can access chat logs, kick players, and mute players.
- Players at this level and above can teleport to specific coordinates on the map.
* 3 - Moderator: This level describes moderators who can help deal with glitches.
- Players at this level and above can return lost items to players.
* 4 - Senior Moderator: This level describes moderators who can help deal with problematic players.
@ -50,7 +51,7 @@ There are 10 total levels, as follows:
- On live servers, their GM level is reset to 0 (Civilian).
* 7 - Inactive Developer: This level describes inactive developers with limited permissions.
* 8 - Active Developer: This level describes players who have been granted all but the most powerful permissions.
- Players at this level and above can spawn entities, instantly smash target players, run macros, and more.
- Players at this level and above can spawn entities, instantly smash target players, send Mythran announcements to all players, run macros, and more.
- **NOTICE:** This GM level should only be granted to trusted players.
* 9 - Server Operator: This level describes players with full access and permissions.
- Players at this level can shut down the server.
@ -58,7 +59,9 @@ There are 10 total levels, as follows:
## Console Commands
Here is a list of all console commands, sorted alphabetically and grouped by required permission level. Each level also has access to the commands of the levels above them. To run one of these console comands, enter them into chat.
Here is a list of all console commands, grouped by required permission level. Each level also has access to the commands of the levels above them. To run one of these console comands, enter them into chat.
Values in `<brackets>` represent necessary parameters, values in `(parens)` represnt optional parameters.
### WORK IN PROGRESS
@ -74,6 +77,364 @@ This command toggles a flag on the current player, which enables that player to
This system functions similarly to Terraria's PvP system; you must enable PvP in order to participate in it, and can disable it at any time.
#### /playanimation <anim-name>
This command triggers the player to play an animation with the given internal name. This can look somewhat buggy, since any player animation can be played, such as attacks that don't match your current gear, but isn't that part of the fun if it?
**TODO: Add a curated list of some fun animations.**
#### /playanim <anim-name>
Alias for `/playanimation`.
#### /die
This command smashes the current player, prompting them to respawn.
#### /resurrect
This command smashes the current player and respawns them.
**TODO: How does this differ from `/die`?**
#### /who
This command outputs a list of all the players in the current instance.
#### /ping (-l)
This commands outputs your average ping level, indicating the strength of your connection to the server. Use `/ping -l` to output your latest ping level rather than your average ping level.
#### /skip-ags
This command will check if the player has been assigned mission ID `229`, and will skip it if they have.
This mission ID corresponds to the required mission in which the player must survive one minute in Avant Gardens Survival. Since this minigame can sometimes be buggy, this command will allow any player to skip the mission if needed.
#### /fix-stats
**TODO: This command's purpose is unknown.**
#### /requestmailcount
**TODO: What does this do?**
#### /instanceinfo
**TODO: What does this do?**
#### /credits
Displays information about the developers of Darkflame Universe.
#### /info
Displays basic information about the currently connected Darkflame Universe server.
#### /leave-zone
**TODO: This requires clarification.**
Moves the current player out of an instanced zone.
#### /join <password>
**TODO: This requires clarification.**
Moves the player to a private instance.
### 2 - Junior Moderator
#### /mute <name> (days) (hours)
Mutes the target player for the target number of days plus the target number of hours.
If no duration is specified, the mute is permanent.
#### /kick <name>
Kicks the target player from the server. They can still login again.
#### /ban <name>
Bans the target player permanently from the server. They cannot login again.
At this time there is no easy functionality to unban a player.
#### /teleport <x> (y) <z>
Teleports to the given X and Z coordinates. If Y is specified, the player will be teleported to that height; otherwise, the player will be teleported to the height of the terrain.
#### /tele
Alias for `/teleport`.
### 3 - Moderator
#### /mailitem <name> <item>
Sends an item to the mailbox of the target player.
### 5 - Lead Moderator
#### /approveproperty
Approves the currently accessed user-built property for public viewing.
### 8 - Active Developer
#### /kill <user>
https://www.youtube.com/watch?v=dyIilW_eBjc
#### /speedboost <boost>
Boost the player's speed by the given amount.
**TODO: Does this support decimal values or only whole numbers?**
#### /freecam
**TODO: Expand description.**
Toggles free camera mode.
#### /setcontrolscheme
**TODO: What does this do?**
#### /list-spawns
**TODO: What does this do?**
#### /unlock-emote
**TODO: What does this do?**
#### /setuistate <state>
**TODO: What does this do?**
#### /toggle <visible>
**TODO: What does this do?**
#### /setinventorysize <size>
Sets the size of the current player's inventory to the specified value.
#### /setinvsize <size>
Alias for `/setinventorysize`.
#### /runmacro <path>
Runs the specified macro at the path `./res/macros/<path>.scm`.
#### /addmission <mission-id>
Forces the current player to accept the mission with the specific ID.
#### /completemission <mission-id>
Immediately completes the mission with the specific ID for the current player.
#### /setflag <flag-id>
Every player has a 12,008-bit string associated with them that contains a large number of on-off switches associated with the character's status and progress. This command enables a specific flag on the current player.
[List of known flags](https://docs.lu-dev.net/en/latest/game-mechanics/flag-system.html#known-flags).
#### /clearflag <flag-id>
Every player has a 12,008-bit string associated with them that contains a large number of on-off switches associated with the character's status and progress. This command disables a specific flag on the current player.
[List of known flags](https://docs.lu-dev.net/en/latest/game-mechanics/flag-system.html#known-flags).
#### /resetmission <mission-id>
Sets a completed mission back as active.
#### /playeffect <effect-id>
Starts playing a specific effect on the given player.
#### /stopeffect <effect-id>
Stops playing a specific effect on the given player.
#### /setanntitle <title>
Set the title of the next announcement to send.
#### /setannmsg <message>
Set the message of the next announcement to send.
#### /getnavmeshheight
**TODO: What does this do?**
#### /gmadditem <lot> (count)
Gives this player an item with a specific LOT. Optionally specify the number of the item to give.
**TODO: Get a list of common item LOTs.**
#### /announce
Send an announcement to all members of the server. You need to call `/setanntitle` and `/setannmsg` first to set the title and description of the message.
#### /setname <name>
Set the current player's name.
**TODO: Is this permanent or what?**
#### /title <title>
Set the current player's title (their name will display as `Name - Title`).
#### /tpall
Teleport all other players to the current player's position.
#### /dismount
Forcibly dismount the player from their vehicle or mount.
#### /buffme
Grants the player 999 Health, Armor, and Imagination.
#### /startcelebration
**TODO: What does this do?**
#### /buffmed
Grants the player 9 Health, Armor, and Imagination.
#### /refillstats
Refills the player's Health, Armor, and Imagination back to full.
#### /lookup <name>
**TODO: What does this do?**
Looks up a player by name and ???
#### /spawn <lot>
Spawns an entity of the given lot.
**TODO: Add IDs for certain common entities.**
#### /giveuscore <amount>
Gives a certain amount of UScore to the current player. They will likely level up because of this.
#### /pos
Prints out the current player's X, Y, and Z position.
#### /rot
Prints out the current player's W, X, Y, and Z rotation.
#### /locrow
Prints out the current player's X, Y, and Z position, and their W, X, Y, and Z rotation.
#### /playlvlfx
**TODO: What does this do?**
#### /playrebuildfx
**TODO: What does this do?**
#### /freemoney <amount>
Gives the current player the specified amount of coins.
#### /setcurrency <amount>
Sets the current player's wallet to the specified amount of coins.
#### /gminvis
Toggles the current player's invisiblity.
#### /gmimmune
**TODO: What does this do?**
#### /buff <id> <duration>
Grants a specified buff for a given duration.
**TODO: Is the duration in seconds?**
**TODO: Build a list of common buffs and debuffs.**
#### /testmap <zone> (force)
Attempt to transport the player to the given world.
Use `/testmap <zone> force` to forcibly teleport to a potentially invalid zone. Can have disastrous results.
#### /createprivate
**TODO: What does this do? Does it have to do with `/join` ?**
#### /debugui
Open the debug UI./testmap
#### /boost
**TODO: What does this do?**
#### /activatespawner <name>
Activate one or more spawners by name.
#### /spawnphysicsverts
**TODO: What does this do?**
#### /reportproxphys
**TODO: What does this do?**
#### /triggerspawner
**TODO: What does this do?**
#### /inspect
#### /reforge <base> <target>
Attempts to create a "reforged" item, which has the appearance of one item and the stats of another.
**DO THIS AT YOUR OWN RISK, VERY BUGGY.**
#### /config-get <name>
Gets a configuration value.
#### /config-set <name> <value>
Sets a configuration value.
**TODO: Make a list of common configuration values.**
#### /metrics
Output a list of server metrics.
### 9 - Server Operator
#### /shutdownuniverse
@ -83,3 +444,49 @@ This command sends an announcement to all players that the server will be shut d
#### /crash
This command immediately crashes the entire Darkflame Universe server, causing players to disconnect without advance warning.
## Available Zone IDs
Below is a list of all of the zones accessible in the base game. Developers can warp to any zone with the `/testmap <id>` command.
ID | Name
---|---
98|UNKNOWN
1000|UNKNOWN
1001|UNKNOWN
1100|UNKNOWN
1101|UNKNOWN
1150|UNKNOWN
1151|UNKNOWN
1152|UNKNOWN
1200|UNKNOWN
1201|UNKNOWN
1250|UNKNOWN
1251|UNKNOWN
1260|UNKNOWN
1300|UNKNOWN
1350|UNKNOWN
1351|UNKNOWN
1400|UNKNOWN
1401|UNKNOWN
1450|UNKNOWN
1451|UNKNOWN
1600|UNKNOWN
1601|UNKNOWN
1602|UNKNOWN
1603|UNKNOWN
1604|UNKNOWN
1800|UNKNOWN
1900|UNKNOWN
2000|UNKNOWN
58004|UNKNOWN
58005|UNKNOWN
58006|UNKNOWN
## Notable Item LOTS
Below is a list of LOT ids for notable items.
ID|Name
---|---
ID|Name

7
native-windows-setup.md Normal file
View File

@ -0,0 +1,7 @@
# Setup Instructions for Darkflame Universe (Native Windows Setup)
The following is a guide to setting up a functioning Darkflame Universe server instance running on your local Windows computer. This process builds the program as an exe you can run on your local computer without having to [utilize WSL](wsl-setup.md).
### WORK IN PROGRESS
Currently, native Windows builds are not functioning for Darkflame Universe. This guide will be updated when we have more information.

5
wsl-setup.md Normal file
View File

@ -0,0 +1,5 @@
# Setup Instructions for Darkflame Universe (WSL Setup)
The following is a guide to setting up a functioning Darkflame Universe server instance running on your local Windows computer. As part of this process, you will be setting up Windows Subsystem for Linux, which is similar to a virtual machine but with fewer performance issues.
### WORK IN PROGRESS