Este projeto é uma API em Java usando o framework Spring Boot para rolagem de dados de RPG.
Com foco no em tornar acessível dados que fogem do padrão e que não estão mais disponíveis no mercado como por exemplo o sistema Star Wars Fronteiras do Empério.
- Dados genéricos
- Star Wars: Fronteiras do Império
Mutant: Ano Zero- Exemplo de uso
- Demo
- Histórico de lançamentos
- Tecnologias utilizadas
- Contribuições
Realiza a rolagem dos dados de acordo com os parâmetros (quantity e faces) recebidos na URL e retorna um JSON com o resultado da rolagem.
- Quantity: quantidade de dados que serão rolados, parâmetro opcional (Default = 1).
- Faces: quantidade de faces dos dados que serão rolados, parâmetro opcional (Default = 20).
Exemplo parâmatro:
?quantity=3&faces=12
Exemplo resultado:
[3,10,8]
Realiza a rolagem dos dados de acordo com os parâmetros (quantity e faces) recebidos na URL e retorna um JSON com o resultado da rolagem.
- Quantity: quantidade de dados de Força que serão rolados, parâmetro opcional (Default = 1).
?quantity=3
Dado | Nome |
---|---|
Dado de força |
Exemplo resultado:
{
"luz": 2,
"negro": 3
}
Resultado | Resultado |
---|---|
Pontos do lado Luz | |
Pontos do lado Negro |
Realiza a rolagem dos dados de acordo com os parâmetros recebidos em um JSON e retorna um objeto JSON com o resultado da rolagem.
Exemplo parâmatro JSON:
{
"habilidade": 3,
"proficiencia": 1,
"dificuldade": 2,
"desafio": 1,
"ampliacao": 1,
"contratempo": 2
}
Exemplo retorno JSON:
{
"sucessos": 3,
"triunfos": 0,
"vantagens": 0,
"fracassos": 0,
"desesperos": 1,
"ameacas": 2
}
Dado | Resultado |
---|---|
Sucessos | |
Vantagens | |
Triunfos | |
Fracassos | |
Ameaças | |
Desesperos |
Alguns exemplos interessantes e úteis sobre como seu projeto pode ser utilizado.
GET https://dice-api.up.railway.app/v1/dice/roll
GET https://dice-api.up.railway.app/v1/dice/roll?quantity=3&faces=12
GET https://dice-api.up.railway.app/v1/dice/sw/force
GET https://dice-api.up.railway.app/v1/dice/sw/force?quantity=4
POST https://dice-api.up.railway.app/v1/dice/sw/roll
Para mais exemplos, consulte a Wiki.
https://dice-api.up.railway.app/
- 1.0.0
- Endpoint GET /v1/dice/roll
- Endpoint POST /v1/dice/sw/roll
- Endpoint GET /v1/dice/sw/force
- Java 19
- Spring Boot
JUnit 5Mockito
- Faça o fork do projeto (https://github.com/grcreutzberg/dice-api/fork)
- Crie uma branch para sua modificação (
git checkout -b feature/newChange
) - Faça o commit (
git commit -am 'Add some feature'
) - Push (
git push origin feature/newChange
) - Crie um novo Pull Request