Skip to content

Commit

Permalink
Update structure of modding guides
Browse files Browse the repository at this point in the history
  • Loading branch information
OrfeasZ committed Feb 28, 2020
1 parent 8e01986 commit d01dfdc
Show file tree
Hide file tree
Showing 22 changed files with 489 additions and 423 deletions.
2 changes: 1 addition & 1 deletion content/general/commands.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Console Commands
title: Console commands
---

VU introduces a few new commands to the in-game console. You can find their details below.
Expand Down
49 changes: 25 additions & 24 deletions content/general/playing.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,26 @@
---
title: Start playing VU
---

Playing VU is as simple as it gets. Below are the steps you need to follow to get started.

## Installing VU & BF3

Download the latest installer from the [downloads page](https://veniceunleashed.net/downloads) and install it on your computer. Make sure that you have downloaded the latest version of Battlefield 3 from Origin (alongside any DLCs you would like to play) and that you have launched the game at least once via Battlelog (either singleplayer or multiplayer). Then, look for the `VU Client` entry on your start menu or your desktop to launch VU.

## Creating an account and linking your Origin account

Before you can play VU, you will need to register an account. You can do so either directly from [here](https://veniceunleashed.net/register) or by launching the client and using the in-game "Create account" button present in the login screen. After you've created your account and logged in to the VU client you will be required to link your Origin account so we can verify your game ownership. This is a one-time process and requires Origin to be running. Once you see the Origin activation prompt, minimize VU, launch Origin and login with an account that owns Battlefield 3. Then return to VU and follow the on-screen prompts. After the process is finished you can turn Origin off if you wish.

## Creating your soldier

After having logged in and linked your Origin account, you will have to create a soldier. A soldier is essentially your unique player. Follow the on-screen prompts and give your soldier a name. That name will be unique among all other players. Things like mod stats and various server-side customizations will be tied to your soldier. You can delete and re-create your soldier at any time. After creating your soldier, you can select it to finish the login process and be able to join servers.

## Joining servers

You should now be in the main menu. There should be several options at the top, one of which is "Servers". If you click on it, you will be presented with VU's in-game server browser. Give it a few seconds to fetch all available servers and then you'll be ready to pick the one you wish to join. From here, you can also filter and sort servers based on your preferences. Click on a server once to see more details or double-click to join. You can also use the `Join` and `Spec` buttons to join or spectate a server respectively (keep in mind that not all servers have spectator capabilities, in which case the `Spec` button will be missing). If a server is grayed out and has a red outline it means that it's incompatible with your VU client and you cannot join it. You can click on it to see more details about what the incompatibility is. When joining a server, VU will automatically download any required mod files, so there's nothing else you'll need to do on your side to join modded servers.

## Disconnecting from a server

---
title: Start playing VU
weight: 1
---

Playing VU is as simple as it gets. Below are the steps you need to follow to get started.

## Installing VU & BF3

Download the latest installer from the [downloads page](https://veniceunleashed.net/downloads) and install it on your computer. Make sure that you have downloaded the latest version of Battlefield 3 from Origin (alongside any DLCs you would like to play) and that you have launched the game at least once via Battlelog (either singleplayer or multiplayer). Then, look for the `VU Client` entry on your start menu or your desktop to launch VU.

## Creating an account and linking your Origin account

Before you can play VU, you will need to register an account. You can do so either directly from [here](https://veniceunleashed.net/register) or by launching the client and using the in-game "Create account" button present in the login screen. After you've created your account and logged in to the VU client you will be required to link your Origin account so we can verify your game ownership. This is a one-time process and requires Origin to be running. Once you see the Origin activation prompt, minimize VU, launch Origin and login with an account that owns Battlefield 3. Then return to VU and follow the on-screen prompts. After the process is finished you can turn Origin off if you wish.

## Creating your soldier

After having logged in and linked your Origin account, you will have to create a soldier. A soldier is essentially your unique player. Follow the on-screen prompts and give your soldier a name. That name will be unique among all other players. Things like mod stats and various server-side customizations will be tied to your soldier. You can delete and re-create your soldier at any time. After creating your soldier, you can select it to finish the login process and be able to join servers.

## Joining servers

You should now be in the main menu. There should be several options at the top, one of which is "Servers". If you click on it, you will be presented with VU's in-game server browser. Give it a few seconds to fetch all available servers and then you'll be ready to pick the one you wish to join. From here, you can also filter and sort servers based on your preferences. Click on a server once to see more details or double-click to join. You can also use the `Join` and `Spec` buttons to join or spectate a server respectively (keep in mind that not all servers have spectator capabilities, in which case the `Spec` button will be missing). If a server is grayed out and has a red outline it means that it's incompatible with your VU client and you cannot join it. You can click on it to see more details about what the incompatibility is. When joining a server, VU will automatically download any required mod files, so there's nothing else you'll need to do on your side to join modded servers.

## Disconnecting from a server

Disconnecting from a server is as simple as using the `Quit` option from the pause menu (which you can bring up by pressing `Esc`). Alternatively, you can open the in-game console using the tilde key (`~`), type `disconnect` or `dc`, and hit `Enter` (you can refer to [this document](/general/commands) for a listing of all available console commands). After you've disconnected from a server, you'll be returned to the main menu.
45 changes: 23 additions & 22 deletions content/modding/_index.md
Original file line number Diff line number Diff line change
@@ -1,23 +1,24 @@
---
title: Modding overview
---

Modding in VU is comprised of several different components and systems, each with its own purpose and functionality.

## Script mods (VeniceEXT)

The first and most important mod system is VeniceEXT. This is VU's custom scripting system which can be used to do everything from modify existing game mechanics to introducing entirely new gameplay experiences. VeniceEXT uses Lua as its underlying scripting language and is compatible with Lua 5.3.

VeniceEXT mods are split into client, server, and shared scripts, which are executed on clients, servers, and both respectively. They can also communicate with each other and coordinate to perform various functions. See [here](/modding/veniceext) for more in-depth details on how VeniceEXT works.

## Custom UI (WebUI)

Another modding component is the WebUI, which is the custom UI layer of VU. Using it, you can create custom in-game UI by utilizing web technologies (such as HTML, CSS, and JS). The UI execution engine itself has limited access to in-game functionality, but it can communicate with VeniceEXT to create interactive experiences. For more information on the WebUI see [here](/modding/webui).

## File mods (Rime)

The last modding component is file modifications using Rime. Rime is a custom Frostbite editor that can be used to view, modify, and author custom game content (such as textures, models, etc.) Rime can create custom game data bundles that can then be loaded by the game via VeniceEXT to either replace existing content (such as textures) or add something entirely new. For more information about Rime see [here](/modding/rime).

---

---
title: Modding overview
weight: 4
---

Modding in VU is comprised of several different components and systems, each with its own purpose and functionality.

## Script mods (VeniceEXT)

The first and most important mod system is VeniceEXT. This is VU's custom scripting system which can be used to do everything from modify existing game mechanics to introducing entirely new gameplay experiences. VeniceEXT uses Lua as its underlying scripting language and is compatible with Lua 5.3.

VeniceEXT mods are split into client, server, and shared scripts, which are executed on clients, servers, and both respectively. They can also communicate with each other and coordinate to perform various functions.

## Custom UI (WebUI)

Another modding component is the WebUI, which is the custom UI layer of VU. Using it, you can create custom in-game UI by utilizing web technologies (such as HTML, CSS, and JS). The UI execution engine itself has limited access to in-game functionality, but it can communicate with VeniceEXT to create interactive experiences.

## File mods (Rime)

The last modding component is file modifications using Rime. Rime is a custom Frostbite editor that can be used to view, modify, and author custom game content (such as textures, models, etc.) Rime can create custom game data bundles that can then be loaded by the game via VeniceEXT to either replace existing content (such as textures) or add something entirely new.

---

Next up, see how [mods are structured](/modding/structure).
Loading

0 comments on commit d01dfdc

Please sign in to comment.