Skip to content

Commit e5dde2a

Browse files
committed
Update README
1 parent 73d9c6e commit e5dde2a

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,37 @@
11
# BB UI addons plugin
22

3+
[![Build status](https://ci.appveyor.com/api/projects/status/w21j2rcek9g9v8vv/branch/master?svg=true)](https://ci.appveyor.com/project/HybridEidolon/psobbaddonplugin/branch/master)
4+
5+
A plugin for Phantasy Star Online Blue Burst that enables graphical UI addons,
6+
which can read the game's memory and present additional useful information.
7+
8+
- [Wiki](https://github.com/HybridEidolon/psobbaddonplugin/wiki)
9+
- [Releases](https://github.com/HybridEidolon/psobbaddonplugin/releases)
10+
11+
## Installation
12+
13+
1. Download the latest release from the [Releases](https://github.com/HybridEidolon/psobbaddonplugin/releases) page
14+
and extract the zip contents to your PSOBB directory.
15+
2. Install the [Visual C++ Redistributable for Visual Studio 2015](https://www.microsoft.com/en-us/download/details.aspx?id=48145).
16+
3. Run the game.
17+
18+
## Building and Testing
19+
20+
To test the lua code, install luacheck and busted from luarocks and
21+
22+
$ luacheck addons
23+
$ busted
24+
25+
To build the plugin dll, use Visual Studio 2015.
26+
27+
## Usage
28+
29+
Press the \` key to open the Main Menu of the addon.
30+
31+
## Changelog
32+
33+
See CHANGELOG.md for more info
34+
335
**The API is completely unstable for now, expect it to change.**
436

537
ImGui is exposed via the `imgui` module, which is in the global environment as `imgui`.
@@ -20,3 +52,4 @@ PSO specific functions are in the `pso` global table.
2052
* read_wstr(addr, len) -- read utf16 str to utf8 at address with len characters, or double null terminated (0 len)
2153
* read_mem(table, addr, len) -- read len bytes from addr into table. the table should be initialized as empty, i.e. `local table = {}; pso.read_mem(table, 0x00400000, 0x7fffffff-0x00400000)` (don't read the entire address space, that's silly and will probably kill the process)
2254
* reload() -- at the end of present, re-initialize the lua state. all addons and modules will be reloaded, no state will be preserved.
55+
* base_address -- the base address of the PSOBB process

0 commit comments

Comments
 (0)