Version

RPGOnline comes with a version API that allows version numbers to be compared.

This was originally based on Semantic Versioning but that lacked the ability to compare snapshots and did not standardise development builds.

Number Format

The version numbers appear in the form: rewrite.major.minor-fix+date.

1. The rewrite number indicates a change to the API that results in most of the code being changed and being incompatible.
2. The major version number indicates changes that have some compatibility with older version but still require some alterations to old code. This usually means removal of deprecated features and the inclusion of new features.
3. The minor version number indicates backwards compatible changes. Small features can be added here.
4. The fix version number when prefixed with p indicates a patch that fixes a small bug without any change in functionality. This can also include optimisation that does not change how code is used.
5. The data field specifies the date of the version as a Unix Timestamp (in seconds).

Note: When the rewrite version is 0 the version is considered to be in beta and the API may change at any time.

Development builds

The fix number can have several prefixes.

• The p prefix indicates a patch version. Patch versions are considered to be after release versions. The number here should be reset when a new minor version is released.
• The rc prefix indicates a release candidate. Release candidates are considered to be before releases but after internal and snapshot versions. The number here should be reset when a new minor version is released.
• The s prefix indicates a snapshot. Snapshots are considered to be before release candidates. The version number here is shared between the development version.
• The d prefix indicates an incomplete development build. These are considered to be equal to a snapshot of the same number. The version number here is shared between the snapshot version.

Example

A example of a series of versions (excluding dates) would look like this:

1. 0.0.0-d0
2. 0.0.0-s1
3. 0.0.0-d2
4. 0.0.0-s3
5. 0.0.0-rc0
6. 0.0.0-rc1
7. 0.0.0
8. 0.0.0-p0
9. 0.0.0-p1
10. 0.1.0-d0
11. 0.1.0-s1
12. 0.1.0-d2
13. 0.1.0-s3
14. 0.1.0-rc0
15. 0.1.0-rc1
16. 1.0.0
17. 1.0.0-p0
18. 1.0.0-p1
19. 1.0.0-d0
20. 1.0.0-s1
21. 1.0.0-d2
22. 1.0.0-s3
23. 1.0.0-rc0
24. 1.0.0-rc1
25. 1.0.0
26. 1.0.0-p0
27. 1.0.0-p1
28. 1.0.1-d0
29. 1.0.1-s1
30. 1.0.1-rc0
31. 1.0.1