Skip to content

Commit 3c246e3

Browse files
authored
Update README.md
1 parent b1178ef commit 3c246e3

File tree

1 file changed

+78
-30
lines changed

1 file changed

+78
-30
lines changed

README.md

Lines changed: 78 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,91 @@
1-
# ScriptSDK
2-
31
## Summary
42

3+
Stealth Client is an alternative Ultima Online client written in Delphi and distributed on their [website](https://stealth.od.ua/ "website"). Stealth exposes a socket based external api which is subject of this project.
4+
5+
ScriptSDK.Api is an implementation of external api. It includes all kind of functions and events to communicate with Stealth.
6+
7+
### Requirements
8+
9+
- [Lombok](https://projectlombok.org/ "Lombok")
10+
11+
- [OpenJDK 17](https://adoptium.net/ "OpenJDK 17")
12+
13+
- [Access to scriptsdk.core](https://github.com/stealth-scriptsdk/java-core "Access to scriptsdk.core")
14+
515
## Features
616

7-
- Implementation of external api methods
8-
- Implementation of custom Methods (XXX)
17+
- Implementation of ApiClient including 422 methods & events
18+
- Implementation of generic api test suite for 418 methods & events
19+
20+
### Excluded methods
21+
22+
- CLEAR_FIGURES
23+
- REMOVE_FIGURE
24+
- ADD_FIGURE
25+
- MESSENGER_GET_CONNECTED
26+
- MESSENGER_SET_CONNECTED
27+
- MESSENGER_GET_TOKEN
28+
- MESSENGER_SET_TOKEN
29+
- MESSENGER_GET_NAM
30+
- MESSENGER_SEND_MESSAGE
31+
- GET_MULTI_ALL_PARTS
32+
- GET_MULTI_PARTS_AT_POSITION
33+
- HTTP_GET
34+
- HTTP_POST
35+
- HTTP_BODY
36+
- HTTP_HEADER
37+
38+
### Excluded test methods
39+
- stopScript
40+
- stopAllScripts
41+
- setTimer1Event
42+
- setTimer2Event
43+
44+
## Installation
45+
46+
### 🛠 Use source code
47+
48+
Developers can fork this repository and use it as it is for their own forks or implementations. Even thought its possible to directly use the sourcecode as base, its recommned to implement this project as maven package.
949

10-
## External API implementation
50+
### 📦 Use as maven package
1151

12-
| Implemented | Existing |
13-
|--|--|
14-
| 377 | 404 |
52+
In order to use Github maven repositories, developers must be registered at github and being able to create a [personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token "personal access token").
1553

16-
## Changelog
54+
As next step the personal access token must be usable through local maven repository by adding a **Settings.xml** to local .m2 folder. This is regulary located at **C:\Users\USER\.m2\**
1755

18-
### Version 0.0.2 (2022-10-14)
56+
```xml
57+
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
58+
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 https://maven.apache.org/xsd/settings-1.0.0.xsd">
59+
<servers>
60+
<server>
61+
<id>github</id>
62+
<username>USERNAME</username>
63+
<password>AUTH_TOKEN</password>
64+
</server>
65+
</servers>
66+
</settings>
67+
```
1968

20-
- Initial Release of Api Client
69+
The last step is adding references to package repository to pom.xml file.
2170

22-
### Version 0.0.1 (2022-10-13)
71+
```xml
72+
<repositories>
73+
<repository>
74+
<id>github</id>
75+
<name>GitHub ScriptSDK Java Core</name>
76+
<url>https://maven.pkg.github.com/stealth-scriptsdk/java-api</url>
77+
<releases><enabled>true</enabled></releases>
78+
<snapshots><enabled>false</enabled></snapshots>
79+
</repository>
80+
</repositories>
81+
```
2382

24-
- Initial Release of Socket Client
25-
- Initial Release of Stealth Client
26-
HTTP_GET(258),
27-
HTTP_POST(259),
28-
HTTP_BODY(260),
29-
HTTP_HEADER(261),
30-
-
3183

32-
CLEAR_FIGURES
33-
REMOVE_FIGURE
34-
ADD_FIGURE
35-
MESSENGER_GET_CONNECTED(501),
36-
MESSENGER_SET_CONNECTED(502),
37-
MESSENGER_GET_TOKEN(503),
38-
MESSENGER_SET_TOKEN(504),
39-
MESSENGER_GET_NAME(505),
40-
MESSENGER_SEND_MESSAGE(506),
4184

42-
GET_MULTI_ALL_PARTS(381),
43-
GET_MULTI_PARTS_AT_POSITION(380),
85+
```xml
86+
<dependency>
87+
<groupId>de.scriptsdk</groupId>
88+
<artifactId>api</artifactId>
89+
<version>1.0.0</version>
90+
</dependency>
91+
```

0 commit comments

Comments
 (0)