🌠 StarRail Infinity 🌠

🌠 StarRail Infinity is a fan-made API proxy to fetch and interact with data from Honkai: Star Rail.

Built with a vision to improve and simplify data access, this project reflects my passion for the game and the broader community.
It is currently a work-in-progress with no hard timelines -- it's a passion project.

``mermaid
classDiagram
class StarRailElysiaServer {
<>
}

class StarRailService {
<>
}

class StarRailApi {
<>
}

class HoyoApi {
<>
}

class User {
<>
}

class Player {
<>
}

class Character {
<>
}

class Equipment {
<>
}

StarRailElysiaServer --> StarRailService : Uses
StarRailService --> User : Manages
StarRailService --> StarRailApi : Uses
User --> Player : Contains
User --> Character : Contains
Character --> Equipment : Contains
StarRailApi --> HoyoApi : Interacts with
`

✨ Features:

$3

**You'll need Bun to be able to run bun commands.
Install Bun with these instructions first!**

After you have Bun installed:
1. Install Dependencies:

`bash
bun install
`

2. Test:

`bash
bun test
`

3. Run the Server:

`bash
bun start
`

or in dev mode

`bash
bun dev
`

4. Documentation and Testing:

- Swagger OpenAPI Docs: http://localhost:3001/swagger
- Fetch a User: http://localhost:3001/user/{uuid} (Replace {uuid} with the specific user's UUID)

🤝 Contribution and Maintenance

This is a personal side-project, developed out of passion and interest; a labor of love for the community.
Contributions are warmly welcomed! If you'd like to contribute, feel free to fork the repository, make your changes, and submit a pull request.
If you have any ideas, suggestions, or issues, don't hesitate to open an issue to discuss it.

⚠️ Disclaimer & License

StarRail Infinity is not affiliated, associated, authorized, endorsed by, or in any way officially connected with the official game or any of its subsidiaries or affiliates. The official game website can be found at https://hsr.hoyoverse.com/.

The software provided as part of StarRail Infinity` is distributed under the terms of the MIT License. This means the software is provided "as is", without any warranties, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement. I, nor any contributors to this project, shall be held liable for any claim, damages, or other liability, whether in action of contract, tort, or otherwise, arising from, out of, or in connection with the software or its use or other dealings in the software.

- StarRail Infinity does not claim any rights or ownership over the data fetched from Honkai: Star Rail. All data remains the property of the official game and its developers.

- Users of StarRail Infinity are expected to respect and adhere to the official Honkai: Star Rail EULA. Any misuse of the data fetched through StarRail Infinity that violates the official game's EULA is strictly the responsibility of the user.

- This project does not modify, reproduce, distribute, or use the fetched data for any commercial endeavors. It solely acts as a proxy to access publicly available information.

- StarRail Infinity is not sponsored, endorsed, or in any way affiliated with the official game. Any representations or implications contrary to this fact are unintentional and will be corrected upon notice.

For the complete terms of the MIT License, please refer to the LICENSE file in this repository.

📞 Contact

If you have any concerns or feedback regarding this project, please feel free open an issue, or get in touch:

- Email: dev@infinia.space
- Discord: infinia

Please note that response times may vary, and replies are on a best-effort basis, as this is a personal side project.