Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 33 additions & 15 deletions .github/ISSUE_TEMPLATE/bug_report_cn.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,42 +7,56 @@ body:
- type: markdown
attributes:
value: |
请确保您使用的是最新版的RC,您反馈的bug很可能已经在更新版本中修复
请确保您使用的是最新版的RealCamera,您反馈的bug很可能已经在更新版本中修复
(查看尾缀是否与最新工件相同)
在反馈bug前,请先尝试搜索是否已有相似的问题,请不要重复打开相同的issue

所有有关YSM的问题,请您优先寻求他人的帮助,或者观看配置模型教程
而不是直接在issue中提问
而不是直接在issue中提问

- type: checkboxes
id: preliminary
attributes:
label: 我已确认 ...
options:
- label: 我正在使用最新版的RC
- label: 我正在使用最新版的RealCamera
required: true
- label: 无法在关闭主要功能时复现
- label: issues里没有相关的问题
required: true

- type: input
id: minecraft-version-loader
id: minecraft-version
attributes:
label: Minecraft版本和加载器
label: Minecraft版本
description: |
请填写游戏版本与所使用的加载器.
你所使用的Minecraft的版本.

你可以在游戏主界面作下角或者游戏启动时的日志开头等地方找到.
你可以在游戏主界面左下角或者游戏启动时的日志开头等地方找到.
validations:
required: true

- type: checkboxes
id: bug-type
attributes:
label: 问题类型
options:
- label: 开启主功能时出现bug
required: false
- label: 与其他模组的兼容问题
required: false
- label: 在fabric端出现
required: false
- label: 在(neo)forge端出现
required: false

- type: textarea
id: incompatible-mods
attributes:
label: 不兼容的mod
description: >-
和bug相关的模组
<br>请在反馈问题前尝试尽可能移除不相干的模组的情况下复现bug
placeholder: 'Mods list here'
<br>请在反馈问题前移除所有不相干的模组的情况下复现bug
placeholder: '与问题有关的模组列表'
render: 'raw'
validations:
required: true
Expand All @@ -52,7 +66,8 @@ body:
attributes:
label: 错误描述
description: >-
请尽可能详细的描述遇到的问题.
请尽可能详细的描述遇到的问题
<br>同时也请务必携带复现时的视频或截图,这对于我们理解问题非常有帮助
<br>越清晰和详尽的描述会使该bug的处理优先级更高
validations:
required: true
Expand All @@ -62,9 +77,9 @@ body:
attributes:
label: 复现步骤
placeholder: |
1. Join the game...
1. 进入游戏...

2. Change some settings...
2. 做出某些改变...

3. ...

Expand All @@ -73,7 +88,10 @@ body:
attributes:
label: 日志和崩溃报告
description: >-
你可以在/logs/lastest.log 和 /crash-report 中找到错误报告,或者使用启动器的导出功能
如果为非崩溃问题,请不要上传日志,这样会不利于我们理解问题
<br>你可以在/logs/lastest.log 和 /crash-report 中找到错误报告,或者使用启动器的导出功能
<br>你可以日志上传到类似 https://paste.ubuntu.com/ 或者 https://mclo.gs/ 的网站并在此贴出链接
<br>**请不要在此此处直接粘贴大段的日志文本!!**
<br>**请不要在此处直接粘贴大段的日志文本!!!**
<br>**请不要在此处直接粘贴大段的日志文本!!!**
<br>**请不要在此处直接粘贴大段的日志文本!!!**
placeholder: '把日志文件往这丢或者使用外部链接'
38 changes: 28 additions & 10 deletions .github/ISSUE_TEMPLATE/bug_report_en.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ body:
Before reporting a bug, please search for similar issues first and avoid opening duplicate issues

For all YSM-related questions, please seek help from others or watch configuration model tutorials first
instead of asking directly in the issue.
instead of asking directly in the issue

- type: checkboxes
id: preliminary
Expand All @@ -21,27 +21,41 @@ body:
options:
- label: I am using the latest version of RealCamera
required: true
- label: Unable to reproduce when main feature is disabled
- label: No related issues found in the issue tracker.
required: true
- label: Appears on Fabric
required: false
- label: Appears on (Neo)Forge
required: false

- type: input
id: minecraft-version-loader
id: minecraft-version
attributes:
label: Minecraft Version and Loader
label: Minecraft Version
description: |
Please specify the game version and your mod loader.
The Minecraft version you are using.

You can find them at the corner of main menu or in the log while startup.
validations:
required: true

- type: checkboxes
id: bug-type
attributes:
label: Question Type
options:
- label: Bug occurs when enabling main feature
required: false
- label: Incompatibility with other mods
required: false

- type: textarea
id: incompatible-mods
attributes:
label: Incompatible Mods
description: >-
The mods related to the bug.
<br>Try to remove unrelated plugins and mods before reporting
The mods related to the bug
<br>Reproduce the bug with all unrelated mods removed before reporting
placeholder: 'Mods list here'
render: 'raw'
validations:
Expand All @@ -52,7 +66,8 @@ body:
attributes:
label: Bug Description
description: >-
Please describe the issue you encountered in as much detail as possible.
Please describe the issue you encountered in as much detail as possible
<br>Please also attach screenshots or reproduction videos, as they help us diagnose the problem effectively
<br>Clearer and more detailed descriptions will receive higher processing priority
validations:
required: true
Expand All @@ -73,7 +88,10 @@ body:
attributes:
label: Logs & Crash Reports
description: >-
You can find error reports in /logs/latest.log and /crash-reports, or use the launcher's export function
If your issue is not a crash, please do not upload log files, as they will hinder our understanding of the problem
<br>You can find error reports in /logs/latest.log and /crash-reports, or use the launcher's export function
<br>You can upload logs to sites like https://paste.ubuntu.com/ or https://mclo.gs/ and post the link here
<br>**DO NOT PASTE LARGE LOGS DIRECTLY HERE!!**
<br>**DO NOT PASTE LARGE LOGS DIRECTLY HERE!!!**
<br>**DO NOT PASTE LARGE LOGS DIRECTLY HERE!!!**
<br>**DO NOT PASTE LARGE LOGS DIRECTLY HERE!!!**
placeholder: 'Drag log file here or use external link'
43 changes: 43 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request_cn.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
name: 新功能建议
description: 为我们提供新的想法
title: "[new feature]:"
labels: [ "new feature" ]
body:
- type: markdown
attributes:
value: |
感谢您花时间提出新的功能想法!
请确保最新版本内没有这个功能!

- type: textarea
id: feature-description
attributes:
label: 这个功能是什么?
description: 请清晰地描述您希望添加的功能
placeholder: 我希望...
validations:
required: true

- type: textarea
id: problem-and-solution
attributes:
label: 这个功能可以解决什么问题?
description: 请详细说明其作用
placeholder: 这个功能可以帮助解决...
validations:
required: true

- type: textarea
id: ideal-solution
attributes:
label: 这个功能理想中的解决方案是什么样的?
description: 例如新的按钮应该在何处,哪里需要新的配置选项
placeholder: 我希望...
validations:
required: true

- type: textarea
id: additional-context
attributes:
label: 其他信息
description: 任何关于功能的上下文或截图
43 changes: 43 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request_en.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,43 @@
name: New Feature Request
description: Suggest an idea for this project
title: "[new feature]: "
labels: [ "new feature" ]
body:
- type: markdown
attributes:
value: |
Thanks for taking the time to suggest a new feature!
Check the latest build to confirm the feature is missing.

- type: textarea
id: feature-description
attributes:
label: What is this feature about?
description: A clear and concise description of what the feature is.
placeholder: I would like to...
validations:
required: true

- type: textarea
id: problem-and-solution
attributes:
label: What problem does this feature solve?
description: Please elaborate on its purpose
placeholder: This feature helps resolve...
validations:
required: true

- type: textarea
id: ideal-solution
attributes:
label: What does your ideal solution look like?
description: For example, where new buttons or config options should be placed
placeholder: I would like...
validations:
required: true

- type: textarea
id: additional-context
attributes:
label: Additional context
description: Any relevant information or screenshots regarding the feature
1 change: 1 addition & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ name: Build
on:
pull_request:
paths-ignore:
- '**/ISSUE_TEMPLATE/**'
- '**/lang/**'
- '**.md'
- 'LICENSE'
Expand Down
35 changes: 23 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
### [中文](README_ZH.md)

Make the camera more realistic in the first-person view.
Supported versions: 1.18.2 - 1.20.4 Forge, 1.18.2 - 26.1 Fabric, 1.21 - 26.1 NeoForge.
Supported versions: 1.18.2 - 1.20.4 Forge, 1.18.2 - 26.2 Fabric, 1.21 - 26.2 NeoForge.
Download the mod from [Releases](https://github.com/xTracr/RealCamera/releases), [Modrinth](https://modrinth.com/mod/real-camera) or [CurseForge](https://curseforge.com/minecraft/mc-mods/real-camera)
Snapshots are [here](https://github.com/xTracr/RealCamera/actions/workflows/build.yml)

Expand All @@ -12,7 +12,7 @@ Snapshots are [here](https://github.com/xTracr/RealCamera/actions/workflows/buil
* Bind the camera to a specific part of the body.
* Customize the position and rotation of the camera.
* Render player model in first-person perspective.
* Use F6 to toggle the feature on or off and other hotkeys to adjust the camera.
* Use 「F6」 to toggle the feature on or off and other hotkeys to adjust the camera.
* Configure these features in the Config Screen (Cloth Config required) and the Model View Screen (0.6+).

### Configuration (0.6+)
Expand All @@ -25,17 +25,27 @@ Snapshots are [here](https://github.com/xTracr/RealCamera/actions/workflows/buil
* From the top right button, enter the `Preview` section, where you can see the relative relationship between the camera and the model and make certain adjustments (you can also adjust through key bindings).
* ![gui_preview](https://cdn.modrinth.com/data/fYYSAh4R/images/44c87a6f1750f8d1b03422120e6042d1098896cb.png)
* Enter a name and save.
* ~~If you have difficulty configuring the settings, you can also enable `Mod Settings > Binding Mode > Legacy Binding Mode`
<br>Note: This setting is exclusive to vanilla Minecraft.~~

#### Tips

* Configs can have their priority adjusted - higher priority configs appear higher in the right-side list
* In the mod settings, you can manually switch between available configurations by modifying the configuration index. You can also set it to a non-zero value to lock the active configuration
* When the main feature is enabled, hover over the configuration entries. The one annotated with `Current Config` is the configuration currently in use
* Disable depth in `Preview` section to hide models blocking the view
* About `Disable` section (current version still rough, complex operations):
* When texture ID field is empty, use Left Alt+Left Click to select texture
* Model parts contained by blue boxes won't be rendered
* Left-click drag to select in texture view, other keys cancel selection
* Left Alt+Left Click quickly selects hovered parts
* In `All` mode, entire texture's model won't render (blue box containing the texture in left panel indicates this)
* About `Disable` section:
* When texture ID field is empty, use 「Left Alt + Left Click」 to select a texture
* Selection modes:
* Single & Multiple selection: Press 「Left Alt + Left Click」 to select the faces to disable
* Range selection: Press 「Left Alt + Left Click」 to confirm the selection area, and use 「Alt + Scroll Wheel」 to adjust the size of the selection area
* In the left texture view of the player rendering area:
* Press 「Left Click」 to start/end drag selection, press any other key to cancel the selection
* Faces selected via drag selection have the same effect as faces disabled via Multiple selection
* Notably, disabling faces this way is generally more performance-efficient than other methods
* Disable modes:
* In `part` mode, selected faces will not be rendered (you can preview the effect by toggling off the visibility of the disable configuration on the right pane)
* In `All` mode, entire texture's model won't render (blue box containing the texture in left panel indicates this)
* ![gui_disable](https://cdn.modrinth.com/data/fYYSAh4R/images/b49ac4da6bf8a59f13c7e93ca1ef76b73e5d23b4.png)

## Dependencies
Expand All @@ -55,10 +65,11 @@ Snapshots are [here](https://github.com/xTracr/RealCamera/actions/workflows/buil
* Why can't i open the Config Screen?
* Please downlowd [Cloth Config API](https://modrinth.com/mod/cloth-config)
* Why does it show binding failed when use YSM models?
* Snapshot 0.6.15 "try" to fix problems, but it didn't fix completely
* If Minecraft version is 1.20.1, then bind upward vector to head left (or right) side, and set roll angle to 90 (or -90) in preview section
* Why does the head of YSM model disappear when in the Model View Screen?
* You downloaded Better Combat, just put it away
* Snapshot 0.6.15 "try" to fix problems, but it didn't fully fix completely
* When your model rotates to a specific angle, the position you bound may disappear due to YSM's `face culling feature`, resulting in binding failure
* You can alleviate this problem by increasing the `Bind Result Retention Frames`
* Why does the disabled texture appear when i downloaded Better Combat and attack?
* Open settings of Better Combat and change Auto to False in First person player animation

### Compatibility

Expand Down
Loading
Loading