Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aatxe/pkgnx
Blazing fast binary data format for video games – PKG4 for Java
https://github.com/aatxe/pkgnx
Last synced: 28 days ago
JSON representation
Blazing fast binary data format for video games – PKG4 for Java
- Host: GitHub
- URL: https://github.com/aatxe/pkgnx
- Owner: aatxe
- License: mit
- Created: 2013-05-27T08:06:26.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2015-04-27T20:34:04.000Z (over 9 years ago)
- Last Synced: 2024-08-02T05:13:01.821Z (3 months ago)
- Language: Java
- Homepage: http://aaronweiss74.github.io/pkgnx/
- Size: 1.08 MB
- Stars: 12
- Watchers: 5
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-blazingly-fast - pkgnx - Blazing fast binary data format for video games – PKG4 for Java (Java)
README
# pkgnx #
pkgnx is a simple Java library for the NX file format. The format was designed by [Peter Atashian](http://github.com/retep998) and [angelsl](https://github.com/angelsl) and has a public specification available [here](http://nxformat.github.io/). The format intended on replacing the proprietary WZ data format designed by Wizet for the popular game, [MapleStory](http://www.maplestory.com).
## Using pkgnx ##
Using pkgnx is really quite simple! The first step, of course, is to include the library as a dependency either by adding it to your classpath or adding it as a maven dependency. Once that's done, you can start coding away. The code itself is quite simple.
You can use an eagerly-loaded NX File like so:
```java
NXFile file = new EagerNXFile("path/to/file");
// Do stuff, like...
System.out.println(file.getRoot().getChild("Mob").getChild("8800000.img"));
// Or...
System.out.println(file.resolve("Mob/8800000.img"));
```
You can use a lazy-loaded NX File like so:
```java
NXFile file = new LazyNXFile("path/to/file");
// Do stuff, like...
System.out.println(file.getRoot().getChild("Mob").getChild("8800000.img"));
// Or...
System.out.println(file.resolve("Mob/8800000.img"));
```
You can also delay the parsing of an eager NX file until later like so:
```java
EagerNXFile file = new EagerNXFile("path/to/file", false);
// Do some other stuff and then later...
file.parse();
```
## Versioning ##
pkgnx follows the [Semantic Versioning guidelines](http://semver.org/). This means that the versions follow the structure Major.Minor.Patch where increments in patch number mean that no API changes took place, increments in minor number mean that all changes are backwards compatible, and increments in major number mean that changes are backwards-incompatible. This should make it easy to know when it's safe for you as a user to update this library!
## Contributing ##
To contribute a patch to pkgnx, simply fork it and run. When you've finished all of your commits, go ahead and send a pull request. All changes are required to match the official format specification and changes that do not fix bugs or add additional functionality will be rejected. This means no style changes!
## Acknowledgements ##
* [Peter Atashian](http://github.com/retep998) and [angelsl](https://github.com/angelsl) for designing the PKG specification.
* [Cedric Van Goethem](https://github.com/Zepheus) for creating [javanx](https://github.com/Zepheus/javanx), the PKG3 Java NX library.
* [angelsl](https://github.com/angelsl) for creating [libjinx](https://github.com/angelsl/ms-libjinx), the first Java NX library, and helping to implement lazy-loading in pkgnx 3.
## Licensing ##
pkgnx is licensed under the MIT License. The full license text can be found in LICENSE.md for your convenience.