aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/.github/ISSUE_TEMPLATE/bug_report.yml
blob: 063bbb7136cedd6fa46d3a0facff7f5daf1a4b8f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
name: Bug Report
description: Report a bug or issue with DropOut Minecraft Launcher
title: "[Bug]: "
labels: ["bug", "needs-triage"]
assignees: []

body:
  - type: markdown
    attributes:
      value: |
        Thank you for taking the time to report a bug! Please fill out the form below to help us understand and fix the issue.

  - type: checkboxes
    id: prerequisites
    attributes:
      label: Prerequisites
      description: Please confirm you have completed the following before submitting. Issues that check "I have not read carefully" or fail to meet required items may be closed immediately.
      options:
        - label: I understand that Issues are for reporting and solving problems, not for comments or complaints. I will provide as much information as possible to help resolve the issue.
          required: false
        - label: I have not read carefully and just clicked through everything, believing this won't affect issue handling.
          required: false
        - label: I have filled in a short and clear title so that developers can quickly identify the issue when browsing the Issue list, rather than "a suggestion" or "stuck" etc.
          required: false
        - label: I have searched existing issues to ensure this is not a duplicate
          required: false
        - label: I am using the latest version of DropOut
          required: false
        - label: I have read the README and documentation
          required: false

  - type: input
    id: version
    attributes:
      label: DropOut Version
      description: What version of DropOut are you using?
      placeholder: "e.g., 0.1.23"
    validations:
      required: true

  - type: dropdown
    id: os
    attributes:
      label: Operating System
      description: Which operating system are you using?
      options:
        - Windows 11
        - Windows 10
        - Windows 8,8.1
        - Windows 7
        - macOS (Apple Silicon)
        - macOS (Intel)
        - Linux (Debian/Ubuntu)
        - Linux (Arch)
        - Linux (Fedora/RHEL)
        - Other Linux
    validations:
      required: true

  - type: input
    id: os-version
    attributes:
      label: OS Version
      description: Specific version of your operating system
      placeholder: "e.g., Windows 11 23H2, macOS 14.2, Ubuntu 22.04"
    validations:
      required: true

  - type: dropdown
    id: minecraft-version
    attributes:
      label: Minecraft Version
      description: Which Minecraft version are you trying to launch?
      options:
        - "1.21.x"
        - "1.20.x"
        - "1.19.x"
        - "1.18.x"
        - "1.17.x"
        - "1.16.x"
        - "1.12.x"
        - Other (specify in description)
    validations:
      required: true

  - type: dropdown
    id: mod-loader
    attributes:
      label: Mod Loader
      description: Are you using a mod loader?
      options:
        - None (Vanilla)
        - Fabric
        - Forge
        - Not applicable
    validations:
      required: true

  - type: input
    id: java-version
    attributes:
      label: Java Version
      description: Which Java version are you using?
      placeholder: "e.g., Java 21.0.1, Java 17.0.9, Java 8u381"
    validations:
      required: true

  - type: dropdown
    id: java-source
    attributes:
      label: Java Source
      description: Where did you get Java from?
      options:
        - Auto-detected by DropOut
        - Downloaded via DropOut
        - Manually installed (Oracle)
        - Manually installed (Sdkman)
        - Manually installed (Homebrew)
        - Manually installed (Chocolatey)
        - Manually installed (Other)
        - Unknown
    validations:
      required: false

  - type: textarea
    id: description
    attributes:
      label: Bug Description
      description: A clear and concise description of what the bug is
      placeholder: Describe the issue you're experiencing...
    validations:
      required: true

  - type: textarea
    id: reproduction
    attributes:
      label: Steps to Reproduce
      description: Steps to reproduce the behavior
      placeholder: |
        1. Go to '...'
        2. Click on '...'
        3. Scroll down to '...'
        4. See error
    validations:
      required: true

  - type: textarea
    id: expected
    attributes:
      label: Expected Behavior
      description: What did you expect to happen?
      placeholder: Describe what you expected to happen...
    validations:
      required: true

  - type: textarea
    id: actual
    attributes:
      label: Actual Behavior
      description: What actually happened?
      placeholder: Describe what actually happened...
    validations:
      required: true

  - type: textarea
    id: logs
    attributes:
      label: Logs and Error Messages
      description: |
        Please upload log files from the DropOut launcher terminal, then paste the log link here.
        
        **How to upload logs:**
        1. Open the terminal in DropOut launcher
        2. Use the built-in log upload feature
        3. Copy the generated log link and paste it below
        
        If automatic upload is unavailable, you can manually retrieve logs from:
        - **macOS**: `$HOME/Library/Application Support/com.dropout.launcher/logs`
        - **Linux**: `$HOME/.local/share/com.dropout.launcher`
      placeholder: |
        Paste log link or log content...
    validations:
      required: false

  - type: textarea
    id: screenshots
    attributes:
      label: Screenshots or Screen Recordings
      description: |
        If applicable, add screenshots or screen recordings to help explain your problem.
        
        **Screenshot Requirements:**
        - Use native screenshot tools (Windows: `Win+Shift+S`, macOS: `Cmd+Shift+4`, Linux: `gnome-screenshot`/`spectacle`)
        - DO NOT use QQ/WeChat/Discord screenshot tools as they may alter resolution and aspect ratio
        - Provide unobstructed original images, avoid window borders or overlays
        - For game-related issues, capture the actual game window
        - Keep the original resolution and DPI
        
        You can compress large files before uploading.
      placeholder: Drag and drop images here or paste image URLs
    validations:
      required: false

  - type: textarea
    id: additional
    attributes:
      label: Additional Context
      description: Add any other context about the problem here
      placeholder: Any additional information that might be helpful...
    validations:
      required: false