marcingoralski/lapisitemeditor

An item editor for the OTB format

LapisItemEditor

This is an item editor for OTB files written in C# using Avalonia. The editor supports the version 11+ file format (appearances.dat & LZMA-compressed sprites).

Currently, the Main functionality of this application is to create items.otb files.

---

There is limited support for changing the default attributes of items, but this functionality is only partially implented and likely buggy.

If you would like to try to improve/implement changing of item attributes, good places to start are

./LapisItemEditor/ViewModels/Main/ItemPropertiesViewModel.cs
./LapisItemEditor/Views/Main/ItemPropertiesView.axaml

There is partial work on support for the older file format (dat & spr), but it is not finished. It can be found under ./Backend/Tibia7.

Credits

Small parts of this repository are copied from the following projects:

• ottools/open-tibia
• ottools/ItemEditor

Also, parts of this repository are inspired by code in the above repositories.

Compiling

1. Open ./LapisItemEditor.sln in Visual Studio.
2. In the solution explorer, right-click the LapisItemEditor project and select Set as Startup Project.
3. Build/Run.

Usage

1. Start the application
2. Select assets folder
3. Select OTB file
4. (optional) Click "Create missing items"
5. (optional) Click "Import item names from file". Item name file must be of format:

[100] void
[3457] a shovel
[35523] an exotic amulet
[...]

6. Click "Save items.otb"

Configuration

Major otb version & client versions can be specified in data/config.json:

{
    "clientVersions": [
        { "name": "12.71", "version": 1271 },
        { "name": "12.72", "version": 1272 },
        { "name": "12.81", "version": 1281 }
    ],
    "majorOtbVersions": [1, 2, 3]
}

Dependencies

• Avalonia
  • Avalonia.Desktop
  • Avalonia.Diagnostics
  • Avalonia.ReactiveUI
• System.Drawing.Common
• SevenZip
• Protobuf

Instructions for generating proto files

1. clone Protod3

2. Get client.exe from <tibia_dir>/packages/Tibia/bin/client.exe

3. Run python3 src/protod.py client.exe

4. Add syntax = "proto2"; as the first line in each .proto file.

5. To generate C# bindings, place .proto files in ./in. Then:

   protoc -I=./in --csharp_out=./out ./in/appearances.proto
   protoc -I=./in --csharp_out=./out ./in/map.proto
   protoc -I=./in --csharp_out=./out ./in/shared.proto