Compare commits

...

19 Commits

Author SHA1 Message Date
fumiko
1d97e66612 Update README.md 2025-03-17 12:48:44 +08:00
fumiko
3355747f2e Update README.md 2025-03-16 01:23:33 +08:00
fumiko
c07804f26c Update README.md 2025-03-16 01:16:47 +08:00
fumiko
b2727924fb Update README.md 2025-03-16 01:10:28 +08:00
fumiko
0381abf602 Update README.md 2025-03-16 00:34:55 +08:00
fumiko
1ceec57422 Merge pull request #178 from Himori-0/main
Update README.md wiki link
2025-02-17 16:25:52 +08:00
Himori
7b20754920 Update README.md 2025-02-15 19:26:50 +07:00
Himori
e6c75c444e Update README.md 2025-02-15 18:32:34 +07:00
Soneoylys
4609498ced GROUP E 2025-01-08 04:20:45 -08:00
Soneoylys
e16c6e2847 typo 2025-01-05 14:32:03 -08:00
Soneoylys
74cb2e815b Merge pull request #141 from I21b/main
Change issue templates to yaml version
2025-01-05 11:10:15 -08:00
Soneoylys
ca170d2a95 Update disclaimer 2025-01-05 11:09:17 -08:00
fumiko
1ee6f00314 Merge pull request #155 from DavidScann/patch-3
Grammatical errors, rephrasing, added legal disclaimer.
2024-10-22 10:39:59 +08:00
DavidScann
0a2b69f970 Fixed more grammar. Added link to TestFlight Group D
Around line 32 -> 40
2024-10-20 23:44:35 -06:00
DavidScann
de631fa648 Grammatical errors, rephrasing, added legal disclaimer.
Line 9, 10 has been updated to include a legal disclaimer regarding our association with SEGA. Which is none.
2024-10-20 23:31:24 -06:00
92
c009cfdcbb Merge branch '2394425147:main' into main 2024-09-30 15:59:17 +09:00
fumiko
66244a15cc Update README.md 2024-09-28 01:36:09 +08:00
92
e25ebfb358 Remove markdown version issue template 2024-09-14 13:41:24 +09:00
92
9fc39c0eb2 Add yaml version issue template 2024-09-14 13:13:46 +09:00
5 changed files with 169 additions and 114 deletions

View File

@@ -1,29 +0,0 @@
---
name: Bug report
about: Create a report to help us improve
title: ''
labels: bug
assignees: '2394425147'
---
**Describe the bug**
A clear and concise description of what the bug is.
**To Reproduce**
Steps to reproduce the behavior:
1.
**Expected behavior**
A clear and concise description of what you expected to happen.
**Screenshots**
If applicable, add screenshots to help explain your problem.
**Device specs**
- Device: [e.g. iPhone6]
- OS: [e.g. iOS8.1]
- Version [e.g. 22]
**Additional context**
Add any other context about the problem here.

83
.github/ISSUE_TEMPLATE/bug_report.yaml vendored Normal file
View File

@@ -0,0 +1,83 @@
name: Bug report
description: Create a report to help us address issues you are facing
title: "[Bug] "
labels: [bug]
body:
- type: checkboxes
id: duplication
attributes:
label:
options:
- label: This issue is not duplicated with any other open or closed issues
required: true
- type: markdown
attributes:
value: |
Thanks for taking the time to make us better!
- type: textarea
id: description
attributes:
label: Describe the bug
description: A clear and concise description of what the bug is
placeholder: |
App crashes on startup every time after changing settings.
validations:
required: true
- type: textarea
id: expected
attributes:
label: Expected behavior
description: A clear and concise description of what you expected to happen
placeholder: |
App started normally, everything worked fine.
validations:
required: true
- type: textarea
id: reproduce
attributes:
label: Steps to reproduce
description: Steps to reproduce the bug
placeholder: |
1. Turn on "Show hitbox" in "Judgement" settings
2. Restart the app
3. Crash
validations:
required: true
- type: textarea
id: environment
attributes:
label: Device information
description: Provide details about your system environment
placeholder: |
Device: [e.g. Pixel 8 Pro]
System: [e.g. Android 15 (AP41.240823.009)]
Version: [e.g. v2.0.0.beta.2.patch.5]
validations:
required: true
- type: textarea
id: screenshots
attributes:
label: Screenshots
description: If applicable, add screenshots to help explain your problem
placeholder: |
modified_setting_items.jpg
crashed_screen.jpg
validations:
required: false
- type: textarea
id: additional
attributes:
label: Additional context
description: Add any other context about the problem here
placeholder: |
Crash report:
validations:
required: false

View File

@@ -1,20 +0,0 @@
---
name: Feature request
about: Suggest an idea for this project
title: ''
labels: enhancement
assignees: '2394425147'
---
**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
**Describe the solution you'd like**
A clear and concise description of what you want to happen.
**Describe alternatives you've considered**
A clear and concise description of any alternative solutions or features you've considered.
**Additional context**
Add any other context or screenshots about the feature request here.

View File

@@ -0,0 +1,51 @@
name: Feature request
description: Suggest features you want to add or suggest to modify existing features
title: "[Feature] "
labels: [enhancement]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to make us better!
- type: textarea
id: related
attributes:
label: Is your feature request related to a problem?
description: A clear and concise description of what the problem
placeholder: |
I'm always frustrated when ...
validations:
required: false
- type: textarea
id: description
attributes:
label: Describe the feature
description: A clear and concise description of what the feature is
validations:
required: true
- type: textarea
id: reasons
attributes:
label: Reason for adding
description: Explain why this feature would be useful to you
validations:
required: true
- type: textarea
id: examples
attributes:
label: Example(s)
description: Post screenshots/drawings/links/etc of the feature request, or proof-of-concept images about the feature
validations:
required: false
- type: textarea
id: additional
attributes:
label: Additional context
description: Add any other context about the feature here
validations:
required: false

100
README.md
View File

@@ -1,91 +1,61 @@
> [!WARNING]
> ### This GitHub repository is the ONLY official source for downloading the game.
> AstroDX is **100% free**, and will never require payment from you.
> If you purchased this game from any third-party website, store, or seller, you have been misled. These entities are not authorized to distribute or monetize this work. Request a refund immediately through the platform/store where you made the purchase. Report the listing to the platform's support team to help prevent further scams.
# AstroDX
![Downloads](https://img.shields.io/github/downloads/2394425147/maipaddx/total?label=Android)
![GitHub release (latest by date)](https://img.shields.io/github/v/release/2394425147/astrodx?label=Stable)
[![Discord](https://dcbadge.vercel.app/api/server/6fpETgpvjZ?style=flat)](https://discord.gg/6fpETgpvjZ)
| Latest (Development) | Latest (Stable) |
|----------------------|-----------------|
| [![Latest (Including pre-release)](https://img.shields.io/github/v/release/2394425147/astrodx?include_prereleases&sort=date)](https://github.com/2394425147/maipaddx/releases/latest) | [![Latest (Pre-beta stable)](https://img.shields.io/github/v/release/2394425147/astrodx?include_prereleases&sort=date&filter=*beta.pre*)](https://github.com/2394425147/maipaddx/releases/latest) |
AstroDX (Formerly MaipadDX) is a mobile maimai simulator intended for those who do not yet have access to a cabinet, those who want to practice, and everyone interested in maimai who otherwise could not play the arcade game.
This game is a clean-room implementation of maimai, and has been developed without using any use of original arcade data.
AstroDX (Formerly MaipadDX) is a mobile maimai simulator intended for those who do not yet have access to a cabinet, those who want to practice, and everyone interested in maimai who otherwise could not play the arcade game.
# Open-source projects
Join our Discord! [![Discord](https://dcbadge.vercel.app/api/server/6fpETgpvjZ?style=flat)](https://discord.gg/6fpETgpvjZ)
- Simai serializer/deserializer: [SimaiSharp](https://github.com/reflektone-games/SimaiSharp)
- Gameplay logic: [AstroDX core-dump](https://github.com/2394425147/maipaddx/tree/main/core-dump)
# Open-source status
We initially intended for AstroDX to be fully open-source after it has been uploaded to official app stores, but as the game contains paid assets, we may only be able to partially open-source AstroDX.
However, if you have issues, please don't hesitate to point it out in issues and we'll try to answer them as best as we can.
This game is a clean-room implementation of maimai, and has been developed without using any original arcade data.
> If you owns the origional copyright of this game (SEGA), or you did other maimai simulator before our first release and concerning about clean-room implementation claim, we may offer you our game project for validating purpose, please contact us.
- For simai interpreter and serializer used in AstroDX: [SimaiSharp](https://github.com/reflektone-games/SimaiSharp)
- For game open-source parts: [AstroDX core-dump](https://github.com/2394425147/maipaddx/tree/main/core-dump)
We intended to open-source AstroDX after publishing to the iOS/Android app stores. Paid assets will be excluded to comply with licenses.
# Q&A
## Seems like my collections aren't getting installed properly in Beta
## How do I download the iOS version?
We went through a redesign for the level storage structure. You can read more here: https://github.com/2394425147/astrodx/issues/115
> [!IMPORTANT]
> Only 10k users can be in a group at any time. Don't join multiple groups if you joined one already.
## Desktop version, and controller support
Join the testing program through [TestFlight Group A](https://testflight.apple.com/join/rACTLjPL), [TestFlight Group B](https://testflight.apple.com/join/ocj3yptn), [TestFlight Group C](https://testflight.apple.com/join/CuMxZE2M), or [TestFlight Group D](https://testflight.apple.com/join/T6qKfV6f) or [TestFlight Group E](https://testflight.apple.com/join/sMm1MCYc).
Currently, AstroDX hasn't released a desktop version(Windows/Linux/macOS), we also have not released any official controller support yet.
Our [Discord server](https://discord.com/channels/892807792996536453/1210127565986205726/1210428179001380946) also offers a live tracker of available seats.
Products such as "ADX controller", "BDX", etc., some of whose names may sound similar to AstroDX, are not associated with us.
## How do I get songs/levels?
We are currently developing our controller API for the desktop version, and our API will be made public along with the desktop version. You may contact the original manufacturers of the controllers to request their support for AstroDX so that you can enjoy our game.
- [Installation Guide for Android](https://wiki.astrodx.com/install/android)
- [Installation Guide for iOS/iPadOS](https://wiki.astrodx.com/install/ios)
## Wait, is there a version for iOS?
Well... It's a bit finnicky. There's a major change happening regarding TestFlight (which you can read more on our Discord server [here](https://discord.com/channels/892807792996536453/1210127565986205726/1238882652040200373)).
**TL;DR: AstroDX for iOS is migrating to a new developer account, and during this period we won't free up more tester slots. However, we hope to finish this transition soon.**
In the meantime, you will still be able to join the tests as per usual.
You can join the test at [TestFlight Group A](https://testflight.apple.com/join/rACTLjPL) or [TestFlight Group B](https://testflight.apple.com/join/ocj3yptn) or [TestFlight Group C](https://testflight.apple.com/join/CuMxZE2M) or [TestFlight Group D](https://testflight.apple.com/join/T6qKfV6f).
![TestFlight](https://img.shields.io/github/downloads/2394425147/maipaddx/total?label=TestFlight)
*Each public link only can hold 10k players (they counted by Apple ID, not devices), so please DO NOT rejoin the test if you already have AstroDX installed.*
## Are there any tutorials on importing?
Detailed guides for Android and iOS are available here:
- [Installation Guide for Android](https://sht.moe/adx-android)
- [Installation Guide for iOS/iPadOS](https://rentry.org/adx_ios)
## Can I use charts transcribed from the official arcade game maimai?
## Can I play converts from maimai?
We **don't recommend** doing this, as it violates SEGA's policies.
## I'm having some issues...
You can open an issue [here](https://github.com/2394425147/maipaddx/issues).
> [!TIP]
> Writing your issue in English allows more people to understand and help you.
> We also recommend searching for other people's issues for solutions first.
**As of May 2024, an attached English translation of the issue is mandatory.**
Open an issue [here](https://github.com/2394425147/astrodx/issues), or join our [Discord server](https://discord.gg/6fpETgpvjZ) to talk about it.
We welcome issues written in Chinese, Japanese and English. However, it would be strongly suggested to provide translations (even using online translator) to English when submitting them, thus other people could understand as well.
## 問題が発生した場合
When submitting issues, please always ensure that you are running the latest released version. We also recommend reviewing existing issues to avoid duplication of questions or concerns.
> [!TIP]
> イシューを英語で記載すると、より多くの人が理解し、助けてくれるでしょう。
Alternatively, on our [Discord server](https://discord.gg/6fpETgpvjZ), we also have a help forum dedicated for issues, an faq, as well as a suggestions channel for feedback.
[こちらから](https://github.com/2394425147/astrodx/issues)イシューを提出するか、[Discordサーバー](https://discord.com/channels/892807792996536453/1210127565986205726/1210428179001380946)に参加して相談してください。
## 質問がある場合
## 我遇到了問題!
イシューは[こちら](https://github.com/2394425147/maipaddx/issues)から提出できます。
> [!TIP]
> 我們强烈建議提供英文翻譯或綫上翻譯以便其他人理解并幫助到你。我們也建議搜索現有的issue以避免重複或疑慮。
中国語、日本語、英語でのイシュー投稿を大歓迎します。ただし、他の方も理解できるように、イシューを提出する際には英文への翻訳を(オンライン翻訳を使用しても)お願いいたします。
イシューを提出する際には、最新バージョンを使用していることチェックしてください。また、重複を避けるため、既存のイシューを確認することをおすすめします。
また、AstroDXの[Discordサーバー](https://discord.gg/6fpETgpvjZ)には、質問用、FAQ、フィードバックのための提案チャンネルもご用意しています。
## 當遇到了問題的時候
可以在[這裏](https://github.com/2394425147/maipaddx/issues)提出issue。
我們歡迎使用中文、日文和英文編寫的issue。然而在提交問題時強烈建議提供英文翻譯甚至使用線上翻譯以便其他人也能理解。
提交issue時請務必確保您正在執行的是最新發布的版本。 我們也建議審查現有issue以避免重複或疑慮。
此外,在我們的[Discord伺服器](https://discord.gg/6fpETgpvjZ)上,還有一個專門解決問題的幫助論壇、常見問題解答以及回饋及建議頻道。
Happy playing!
在[這裏](https://github.com/2394425147/astrodx/issues)提交你的issue或在我們的[Discord伺服器](https://discord.gg/6fpETgpvjZ)上一起討論。