mirror of
https://github.com/AlmostReliable/almostunified.git
synced 2024-11-27 10:05:47 -05:00
129 lines
6 KiB
Markdown
129 lines
6 KiB
Markdown
<h1 align="center">
|
|
<a href="https://github.com/AlmostReliable/almostunified"><img src=https://i.imgur.com/3b7Gjkn.png" alt="Preview" width=200></a>
|
|
<p>Almost Unified</p>
|
|
</h1>
|
|
|
|
<div align="center">
|
|
|
|
A [Minecraft] mod to unify resources.
|
|
|
|
[![Workflow Status][workflow_status_badge]][workflow_status_link]
|
|
![License][license_badge]
|
|
|
|
[![Version][version_badge]][version_link]
|
|
[![Total Downloads CF][total_downloads_cf_badge]][curseforge]
|
|
[![Total Downloads MR][total_downloads_mr_badge]][modrinth]
|
|
|
|
[![Discord][discord_badge]][discord]
|
|
[![Wiki][wiki_badge]][wiki]
|
|
|
|
</div>
|
|
|
|
## **📖 Information**
|
|
For an in-depth explanation of the mod, its functionality, config descriptions, FAQs and more, check out the [wiki].
|
|
|
|
## **🔧 Manual Installation**
|
|
1. Download the latest **mod jar** from the [releases], from [CurseForge] or [Modrinth].
|
|
2. Install Minecraft [NeoForge] or [Fabric].
|
|
3. Drop the **jar file** into your mods folder.
|
|
|
|
## **🔗 Depending on the Mod**
|
|
|
|
### Maven
|
|
Every release of this project is built on and published to the [BlameJared] maven.
|
|
|
|
```groovy
|
|
repositories {
|
|
maven {
|
|
url = 'https://maven.blamejared.com'
|
|
name = 'BlameJared Maven'
|
|
}
|
|
}
|
|
```
|
|
|
|
### Common [![Maven][maven_common_badge]][maven_common_link]
|
|
```groovy
|
|
dependencies {
|
|
modCompileOnly("com.almostreliable.mods:almostunified-common:<version>:api")
|
|
}
|
|
```
|
|
|
|
### Fabric [![Maven][maven_fabric_badge]][maven_fabric_link]
|
|
```groovy
|
|
dependencies {
|
|
modCompileOnly("com.almostreliable.mods:almostunified-fabric:<version>:api")
|
|
modRuntimeOnly("com.almostreliable.mods:almostunified-fabric:<version>")
|
|
}
|
|
```
|
|
|
|
### NeoForge [![Maven][maven_neoforge_badge]][maven_neoforge_link]
|
|
```groovy
|
|
dependencies {
|
|
compileOnly("com.almostreliable.mods:almostunified-neoforge:<version>:api")
|
|
runtimeOnly("com.almostreliable.mods:almostunified-neoforge:<version>")
|
|
}
|
|
```
|
|
|
|
### Examples
|
|
For code examples on how to use the API, check out the [wiki][api-wiki].
|
|
|
|
## **🖥️ Dev Environment Setup**
|
|
1. Clone the repository
|
|
2. Import into IntelliJ (VSCode and Eclipse are not tested)
|
|
3. Run
|
|
- `gradle -> common -> Tasks -> fabric -> genSources`
|
|
- `gradle -> fabric -> Tasks -> fabric -> genSources`
|
|
- `gradle -> neoforge -> Tasks -> loom -> genSources`
|
|
- `gradle -> Tasks -> buildconfig -> generateBuildConfig`
|
|
4. Restart the IDE
|
|
|
|
The `common` module uses [fabric-loom]. This allows to use [ParchmentMC][parchment].<br>
|
|
Do not use Fabric related features inside the `common` module!
|
|
|
|
## **💚 Credits**
|
|
The logo was made by [mo_shark].
|
|
|
|
## **🎓 License**
|
|
This project is All Rights Reserved. Forks should only be created with the intent of submitting changes to the upstream
|
|
repository via pull requests.
|
|
|
|
The license applies exclusively to the project's source code. Versions published on CurseForge and Modrinth may be used
|
|
for gameplay and modpack creation, provided they are downloaded directly from these platforms. GitHub releases are
|
|
intended for private use or as a fallback if CurseForge and Modrinth are unavailable.
|
|
|
|
The project's API can be freely used in other mods, as long as this project is not an included dependency. This includes
|
|
custom inclusion methods like Jar-in-Jar.
|
|
|
|
Redistribution of builds or rehosting is strictly prohibited.
|
|
|
|
<!-- Badges -->
|
|
[workflow_status_badge]: https://img.shields.io/github/actions/workflow/status/AlmostReliable/almostunified/build.yml?branch=1.21.1&style=for-the-badge
|
|
[workflow_status_link]: https://github.com/AlmostReliable/almostunified/actions
|
|
[license_badge]: https://img.shields.io/badge/License-ARR-ffa200?style=for-the-badge
|
|
[version_badge]: https://img.shields.io/badge/dynamic/json?color=0078FF&label=release&style=for-the-badge&query=name&url=https://api.razonyang.com/v1/github/tag/AlmostReliable/almostunified%3Fprefix=v1.21.1-
|
|
[version_link]: https://github.com/AlmostReliable/almostunified/releases/latest
|
|
[total_downloads_cf_badge]: https://img.shields.io/badge/dynamic/json?color=e04e14&label=CurseForge&style=for-the-badge&query=downloads.total&url=https%3A%2F%2Fapi.cfwidget.com%2F633823&logo=curseforge
|
|
[total_downloads_mr_badge]: https://img.shields.io/modrinth/dt/sdaSaQEz?color=5da545&label=Modrinth&style=for-the-badge&logo=modrinth
|
|
[discord_badge]: https://img.shields.io/discord/917251858974789693?color=5865f2&label=Discord&logo=discord&style=for-the-badge
|
|
[wiki_badge]: https://img.shields.io/badge/Read%20the-Wiki-ba00ff?style=for-the-badge
|
|
[maven_common_badge]: https://img.shields.io/maven-metadata/v?color=C71A36&label=Latest%20version&logo=Latest%20version&metadataUrl=https%3A%2F%2Fmaven.blamejared.com%2Fcom%2Falmostreliable%2Fmods%2Falmostunified-common%2Fmaven-metadata.xml&style=flat-square
|
|
[maven_common_link]: https://maven.blamejared.com/com/almostreliable/mods/almostunified-common/
|
|
[maven_fabric_badge]: https://img.shields.io/maven-metadata/v?color=C71A36&label=Latest%20version&logo=Latest%20version&metadataUrl=https%3A%2F%2Fmaven.blamejared.com%2Fcom%2Falmostreliable%2Fmods%2Falmostunified-fabric%2Fmaven-metadata.xml&style=flat-square
|
|
[maven_fabric_link]: https://maven.blamejared.com/com/almostreliable/mods/almostunified-fabric/
|
|
[maven_neoforge_badge]: https://img.shields.io/maven-metadata/v?color=C71A36&label=Latest%20version&logo=Latest%20version&metadataUrl=https%3A%2F%2Fmaven.blamejared.com%2Fcom%2Falmostreliable%2Fmods%2Falmostunified-forge%2Fmaven-metadata.xml&style=flat-square
|
|
[maven_neoforge_link]: https://maven.blamejared.com/com/almostreliable/mods/almostunified-forge/
|
|
|
|
<!-- Links -->
|
|
[minecraft]: https://www.minecraft.net/
|
|
[discord]: https://discord.com/invite/ThFnwZCyYY
|
|
[wiki]: https://github.com/AlmostReliable/almostunified/wiki
|
|
[curseforge]: https://www.curseforge.com/minecraft/mc-mods/almost-unified
|
|
[modrinth]: https://modrinth.com/mod/almost-unified
|
|
[releases]: https://github.com/AlmostReliable/almostunified/releases
|
|
[neoforge]: https://neoforged.net/
|
|
[fabric]: https://fabricmc.net/
|
|
[blamejared]: https://maven.blamejared.com
|
|
[api-wiki]: https://github.com/AlmostReliable/almostunified/wiki/API
|
|
[fabric-loom]: https://github.com/FabricMC/fabric-loom
|
|
[parchment]: https://parchmentmc.org/
|
|
[mo_shark]: https://www.curseforge.com/members/mo_shark
|