Skip to content

Quick start

Jump to bottom
AdrienTD edited this page Mar 20, 2022 · 3 revisions

Quick start

WIP

Setup

  1. Download the latest version from https://github.com/AdrienTD/XXL-Editor/releases (the xec-v***.zip file)
  2. Extract the zip (to a new empty folder)
  3. Launch the XXL-Editor.exe file

The Project screen

XXL Editor Project screen

When you launch the editor, the screen shown above will appear. This is the project manager which lets you create and manage modding projects.

To mod the game, you first need to create a project file. This can be done by either the "Create mod project from patched XXL1/2 PC copy" or "Create mod project from existing files" buttons. Which one depends on the game you want to mod:

  • "Create mod project from patched XXL1/2 PC copy" if you want to mod the original PC versions of XXL1 or XXL2. Both games have DRM that affect the game files (I might explain this later in another wiki page). Due to this, the editor won't be able to open the level files. Using this button will let you create a patched copy of the game which then can be opened and modified in the editor. The project file will also be automatically created and added to the project list.

  • "Create mod project from existing files" for console versions of XXL1/2 and other games (including the remasters). These games don't have any DRM affecting the level files, hence no patching required. You create a project file by indicated the game version, platform and path to the game's folder. Then you save the project file which is then added in the project list.

Once a project file is created, it will be added automatically to the project list. Select the project then click "Open" (or double-click the project) to open the project and start messing with the game's levels!

Editor basics

Once you open a project, the editor will look like this:

Camera

Use the arrow keys or WASD keys to move the camera.

Hold the right mouse button or Numpad0 key and move the mouse to rotate the camera.

Window menu

Clicking Window at the top of the editor's window will reveal a list of windows that the editor provides. Clicking one of them will open the window.

Main window

The Main window is the first window opened by default. Here you can:

  • Load a level: type the level number in the Level number field at the top and click Load.
  • Save the level: clicking Save will save the level so that you can play in the game.
  • Test the level: if a path to the GameModule is provided in the Project settings, the Test button appears. Clicking it will launch the game and automatically load the level indicated in the Level number field. (Note that there's a bug where it won't load the level automatically, in this case click the Test button again.)
  • Camera settings allow you to change position, orientation, movement speed, depth range, Orthographic mode, Top-down view.
  • The Show sector field allows you to set which sector to render. -1 will render all sectors. The common sector (loading tunnels) are always rendered.
  • Set of checkboxes which let you decide which kind of objects you want to show or hide.
Clone this wiki locally