@lycoristech/azurapi 0.0.3 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,12 +1,12 @@
1
1
  <img src="https://github.com/iujab/azurlane-images/blob/main/banner.png" />
2
2
 
3
- # AzurAPI - js
3
+ # LycorisTech/AzurAPI
4
4
 
5
5
  A self-maintained, current Azur Lane data library. Drop-in replacement for the `@azurapi/azurapi` package.
6
6
 
7
7
  ## Why?
8
8
 
9
- The older and amazing `@azurapi/azurapi` ecosystem is now 3+ years stale. I have fond memories starting off my computer science hobby building a discord bot using that API. Recently, when revisiting that project, I noticed that the azurapi package was years out of date, likely due to the wiki scraper method no longer being viable. This AzurAPI builds on the [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData) and [nobbyfix/AzurLane-AssetDownloader](https://github.com/nobbyfix/AzurLane-AssetDownloader) repos so our data stays fresh within hours of each game patch.
9
+ The older and amazing `@azurapi/azurapi` ecosystem is now 3+ years stale. I have fond memories starting off my computer science hobby building a discord bot using that API. Recently, when revisiting my old discord bot, I noticed that the azurapi package was years out of date, likely due to the wiki scraper method no longer being viable. This AzurAPI builds on the [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData) and [nobbyfix/AzurLane-AssetDownloader](https://github.com/nobbyfix/AzurLane-AssetDownloader) repos so our data stays fresh within hours of each game patch.
10
10
 
11
11
  ## Installation
12
12
 
@@ -43,6 +43,14 @@ const results = azur.ships.search("Enterp", 5); // top 5 matches
43
43
 
44
44
  That's it. The `ships.get()` API is compatible. Ship objects match the same schema!
45
45
 
46
+ ### Relationship to the original AzurAPI project
47
+
48
+ This library is a **schema-compatible successor** to [`@azurapi/azurapi`](https://github.com/AzurAPI/azurapi-js) (GPL-3.0) and its sister data repo [`AzurAPI/azurapi-js-setup`](https://github.com/AzurAPI/azurapi-js-setup) (AGPL-3.0).
49
+
50
+ **This project is not a fork and does not contain any code from those repositories.** It is an independent rewrite built from scratch against the decompiled game data from [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData), which is a completely separate data source.
51
+
52
+ The output JSON schema (field names, structure, rarity values, etc.) is deliberately kept shape-compatible with the original so existing devs can migrate with a single import change.
53
+
46
54
  ## Data Freshness
47
55
 
48
56
  Data is auto-refreshed weekly (every Monday) via GitHub Actions from [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData) (EN + CN + JP regions). The refresh pipeline:
@@ -71,7 +79,7 @@ Ships have the full AzurAPI-compatible shape including:
71
79
  The committed `data/ships.json` is fetchable via GitHub raw URL:
72
80
 
73
81
  ```
74
- https://raw.githubusercontent.com/iujab/AzurAPI/main/data/ships.json
82
+ https://raw.githubusercontent.com/iujab/Lycoris-AzurAPI/main/data/ships.json
75
83
  ```
76
84
 
77
85
  Also available: `ship-list.json` (minimal index), `id-map.json` (name→id lookup), `version.json`.
@@ -102,12 +110,12 @@ Ship paintings and thumbnails are hosted in a separate GitHub repo: [iujab/azurl
102
110
  - **Paintings** — skin art in WebP format (`paintings/{asset_name}.webp`)
103
111
  - **Thumbnails** — shipyard icons in PNG format (`thumbnails/{group_type}.png`)
104
112
 
105
- ## License
113
+ ## License and Rights
106
114
 
107
- MIT for the code. Game data is extracted from publicly available game files and is the property of Yostar/Manjuu/Yongshi. This project is not affiliated with or endorsed by any of these companies.
115
+ This is an **unofficial, non-commercial, community-maintained fan project**. It is not developed, endorsed, sponsored, or in any way affiliated with Manjuu, Yongshi, Yostar, or any of their subsidiaries.
108
116
 
109
117
  ## Acknowledgments
110
118
 
111
119
  - [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData) — upstream auto-updating game data
112
120
  - [nobbyfix/AzurLane-AssetDownloader](https://github.com/nobbyfix/AzurLane-AssetDownloader) — game asset extraction
113
- - [AzurAPI/azurapi-js](https://github.com/AzurAPI/azurapi-js) — the original library whose schema we replicate, and is the base inspiration for this project!❤️
121
+ - [AzurAPI/azurapi-js](https://github.com/AzurAPI/azurapi-js) — the original library whose schema we replicate, and the base inspiration for this project!❤️