Skip to content

Commit 0faea26

Browse files
authored
Merge pull request #44 from Jabbo16/patch-1
Better readme
2 parents 6909bf6 + c924c9a commit 0faea26

File tree

1 file changed

+26
-21
lines changed

1 file changed

+26
-21
lines changed

README.md

Lines changed: 26 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,27 +1,32 @@
11
[![Build Status](https://travis-ci.org/JavaBWAPI/JBWAPI.svg?branch=develop)](https://travis-ci.org/JavaBWAPI/JBWAPI)[![Total alerts](https://img.shields.io/lgtm/alerts/g/JavaBWAPI/JBWAPI.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/JavaBWAPI/JBWAPI/alerts/)[![Language grade: Java](https://img.shields.io/lgtm/grade/java/g/JavaBWAPI/JBWAPI.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/JavaBWAPI/JBWAPI/context:java)
22
# JBWAPI
3+
34
Pure Java [bwapi](https://github.com/bwapi/bwapi) 4.4.0 client implementation backed by [N00byEdge](https://github.com/N00byEdge)'s [JavaBWAPIBackend](https://github.com/N00byEdge/JavaBWAPIBackend) idea and automated by [Bytekeeper](https://github.com/Bytekeeper).
45

56
Also contains a modified version of the pure Java BWEM implementation from [BWAPI4J](https://github.com/OpenBW/BWAPI4J).
67

7-
## goals
8+
## Goals
9+
810
- Have a similar (Java) interface to BWMirror to make porting BWMirror bots easy without all the DLL and JNI hassle and overhead.
9-
- Stay as updated as possible with the BWAPI releases
11+
- Stay as updated as possible with the BWAPI releases.
12+
13+
## Advantages
14+
15+
- No dependency on external DLL's.
16+
- At least [5x](https://github.com/JavaBWAPI/JBWAPI/issues/17) faster compared to bwmirror for primitives as it directly reads the memory mapped client file. Even faster for bwapi objects as it also avoids type marshalling
17+
- Supports both 32 and 64 bit Java (e.g. [deeplearning4j](https://deeplearning4j.org/) requires 64 bit Java which bwmirror doesn't support).
18+
- BWEM instead of BWTA as map analyser.
1019

11-
## advantages
12-
- no dependency on external DLL's
13-
- at least [5x](https://github.com/JavaBWAPI/JBWAPI/issues/17) faster compared to bwmirror for primitives as it directly reads the memory mapped client file. Even faster for bwapi objects as it also avoids type marshalling
14-
- supports both 32 and 64 bit Java (e.g. [deeplearning4j](https://deeplearning4j.org/) requires 64 bit Java which bwmirror doesn't support)
15-
- BWEM instead of BWTA as map analyser
20+
## Warnings
1621

17-
## warnings
18-
- JBWAPI by default has Lateny Compensation disabled (and at the moment has no LatCom at all).
22+
- JBWAPI by default has Latency Compensation disabled (and at the moment has no LatCom at all).
1923
- A fake BWTA is provided for easier porting, but it translates BWTA calls to their respective BWEM calls, so specific Regions/Chokepoints etc. may differ.
2024

21-
## usage
22-
**maven**
25+
## Usage
2326

24-
Add JitPack as a repository
27+
**Maven**
28+
29+
Add JitPack as a repository:
2530
```
2631
<repositories>
2732
<repository>
@@ -30,7 +35,7 @@ Add JitPack as a repository
3035
</repository>
3136
</repositories>
3237
```
33-
Add JBWAPI as a dependecy
38+
Add JBWAPI as a dependency:
3439
```
3540
<dependency>
3641
<groupId>com.github.JavaBWAPI</groupId>
@@ -39,9 +44,9 @@ Add JBWAPI as a dependecy
3944
</dependency>
4045
```
4146

42-
**gradle**
47+
**Gradle**
4348

44-
Add JitPack as a repository
49+
Add JitPack as a repository:
4550
```
4651
allprojects {
4752
repositories {
@@ -50,31 +55,31 @@ allprojects {
5055
}
5156
}
5257
```
53-
Add JBWAPI as a dependency
58+
Add JBWAPI as a dependency:
5459
```
5560
dependencies {
5661
implementation 'com.github.JavaBWAPI:JBWAPI:0.8'
5762
}
5863
```
5964

60-
**jar**
65+
**Jar**
6166

6267
Alternatively add the latest .jar from the [releases](https://github.com/JavaBWAPI/JBWAPI/releases) page to your project.
6368

64-
## compilation
69+
## Compilation
70+
6571
`mvnw.cmd package`
6672

6773
or if you already have maven installed
6874

6975
`mvn package`
7076

71-
## documentation
77+
## Documentation
7278

7379
The API documentation can be found [here](https://javabwapi.github.io/JBWAPI/).
7480

7581
You can also ask any further questions on the [SSCAIT Discord](https://discord.gg/DqvHsq9)
7682

77-
## tutorial
83+
## Tutorial
7884

7985
If you are a just starting out with bot development, it might be helpful to follow the [tutorial](https://github.com/JavaBWAPI/Java-BWAPI-Tutorial/wiki)!
80-

0 commit comments

Comments
 (0)