update 2023/5/6 nbs基础

Signed-off-by: Eilles Wan <w-yi_doctoryi@outlook.com>

.gitattributes

@@ -0,0 +1,3 @@
+*.yaml linguist-language=Python
+*.xml linguist-language=Python
+*.md linguist-language=Python

.gitignore

@@ -0,0 +1,163 @@
+# sth. can't open
+/msctPkgver/secrets/*.py
+/msctPkgver/secrets/*.c
+
+
+# mystuff
+/.vscode
+*.mid
+*.midi
+*.mcpack
+*.bdx
+*.json
+*.mcstructure
+/logs
+/languages
+/llc_cli.py
+/utils
+test.py
+
+# Byte-compiled / optimized
+__pycache__/
+*.pyc
+*$py.class
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Pycharm
+/.idea
+
+# log
+/.log
+
+# package
+.7z

.idea/.gitignore

@@ -1,3 +0,0 @@
-# Default ignored files
-/shelf/
-/workspace.xml

.idea/Musicreater.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="PYTHON_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$" />
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-  <component name="PyDocumentationSettings">
-    <option name="format" value="PLAIN" />
-    <option name="myDocStringFormat" value="Plain" />
-  </component>
-</module>

.idea/inspectionProfiles/Project_Default.xml

@@ -1,46 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="LongLine" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyArgumentEqualDefaultInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyAugmentAssignmentInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyClassicStyleClassInspection" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyCompatibilityInspection" enabled="false" level="WARNING" enabled_by_default="false">
-      <option name="ourVersions">
-        <value>
-          <list size="1">
-            <item index="0" class="java.lang.String" itemvalue="3.10" />
-          </list>
-        </value>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyMandatoryEncodingInspection" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyMissingTypeHintsInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true" />
-    <inspection_tool class="PyPep8Inspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="ignoredErrors">
-        <list>
-          <option value="E501" />
-        </list>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyPep8NamingInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
-      <option name="ignoredErrors">
-        <list>
-          <option value="N802" />
-          <option value="N803" />
-          <option value="N806" />
-          <option value="N813" />
-          <option value="N801" />
-        </list>
-      </option>
-    </inspection_tool>
-    <inspection_tool class="PyUnresolvedReferencesInspection" enabled="true" level="WARNING" enabled_by_default="true">
-      <option name="ignoredIdentifiers">
-        <list>
-          <option value="list.__getitem__" />
-          <option value="list.split" />
-        </list>
-      </option>
-    </inspection_tool>
-  </profile>
-</component>

.idea/inspectionProfiles/profiles_settings.xml

@@ -1,6 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <settings>
-    <option name="USE_PROJECT_PROFILE" value="false" />
-    <version value="1.0" />
-  </settings>
-</component>

.idea/misc.xml

@@ -1,4 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.9" project-jdk-type="Python SDK" />
-</project>

.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/Musicreater.iml" filepath="$PROJECT_DIR$/.idea/Musicreater.iml" />
-    </modules>
-  </component>
-</project>

.idea/vcs.xml

@@ -1,6 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="VcsDirectoryMappings">
-    <mapping directory="$PROJECT_DIR$" vcs="Git" />
-  </component>
-</project>

LICENSE.md

@@ -1,192 +1,219 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works within the Source form or
-          documentation, if provided along with the Derivative Works or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-
-   Copyright 2022 Eilles Wan (金羿)
-
-   Licensed under the Apache License, Version 2.0 (the "License")
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-
+**注意，以下条款或版权声明应当且必须是高于此项目中任何其他声明的**
+
+1. 音·创的全部开发者享有其完整版权，其开发者可以在任一时刻终止以后音·创源代码开放，若经由其开发者授予特殊权利，则授权对象可以将源代码进行特定的被特殊授权的操作
+2. 音·创或（及）其代码允许在 Apache2.0 协议的条款与说明下进行非商业使用
+3. 除部分代码特殊声明外，音·创允许对其或（及）其代码进行商业化使用，但是需要经过音·创主要开发者（诸葛亮与八卦阵、金羿）的一致授权，同时，授权对象在商业化授权的使用过程中必须依照 Apache2.0 协议的条款与说明
+4. 若存在对于音·创包含的部分代码的特殊开源声明，则此部分代码依照其特定的开源方式授权，但若此部分代码经由此部分代码的主要开发者一致特殊授权后商用，则授权对象在商用时依照此部分的开发者所准许的方式（或条款）进行商用，或默认依照 Apache2.0 协议进行商业化使用
+5. Apache2.0 协议的英文原文副本可见下文
+
+>  The English Translation of the TERMS AND CONDITIONS above is listed below
+>
+>  This translated version is for reference only and has no legal effect.
+>
+>  The version with legal effect is the Chinese version above.
+
+**Note, The TERMS AND CONDITIONS below should and must be above all others in this project**
+
+1. *Musicreater* is fully copyrighted by all its developers, the developers have the right to make *Musicreater* close sourced at any time. Operations are permitted under specific terms instructed by its developer(s).
+2. Non-commercial use of *Musicreater* and(or) its source code is permitted under Apache License 2.0.
+3. Commercial use of *Musicreater* is permitted under Apache License 2.0 with the unanimous permission of the steering developers of *Musicreater* (*bgArray*诸葛亮与八卦阵 and *Eilles*金羿). 
+4. *Musicreater* is open sourced under priority given:
+   1. License granted by the core developer(s) of a section after negotiation.
+   2. Explicitly stated license.
+   3. Apache 2.0 License.
+5. A copy of the original Apache Lisence 2.0 can be found below.
+
+
+```text
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+
+   Copyright 2022 Team-Ryoun 金羿("Eilles Wan") & 诸葛亮与八卦阵("bgArray")
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+```

Musicreater/__init__.py

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+"""一个简单的我的世界音频转换库
+音·创 (Musicreater)
+是一款免费开源的针对《我的世界》的midi音乐转换库
+Musicreater(音·创)
+A free open source library used for convert midi file into formats that is suitable for **Minecraft**.
+
+版权所有 © 2023 音·创 开发者
+Copyright © 2023 all the developers of Musicreater
+
+开源相关声明请见 ../License.md
+Terms & Conditions: ../License.md
+"""
+
+# 睿穆组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 版权所有 金羿("Eilles Wan") & 诸葛亮与八卦阵("bgArray") & 鸣凤鸽子("MingFengPigeon")
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+from .main import *
+
+__version__ = "0.5.1"
+__all__ = []
+__author__ = (("金羿", "Eilles Wan"), ("诸葛亮与八卦阵", "bgArray"), ("鸣凤鸽子", "MingFengPigeon"))

Musicreater/exceptions.py

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*-
+
+
+# 睿穆组织 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 版权所有 金羿("Eilles Wan") & 诸葛亮与八卦阵("bgArray") & 鸣凤鸽子("MingFengPigeon")
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+
+"""一个简单的我的世界音频转换库
+音·创 (Musicreater)
+是一款免费开源的针对《我的世界》的midi音乐转换库
+Musicreater(音·创)
+A free open source library used for convert midi file into formats that is suitable for **Minecraft**.
+
+版权所有 © 2023 音·创 开发者
+Copyright © 2023 all the developers of Musicreater
+
+开源相关声明请见 ../License.md
+Terms & Conditions: ../License.md
+"""
+
+
+class MSCTBaseException(Exception):
+    """音·创库版本的所有错误均继承于此"""
+
+    def __init__(self, *args):
+        """音·创库版本的所有错误均继承于此"""
+        super().__init__(*args)
+
+    def miao(
+            self,
+    ):
+        for i in self.args:
+            print(i + "喵！")
+
+    def crash_it(self):
+        raise self
+
+
+class MidiFormatException(MSCTBaseException):
+    """音·创库版本的所有MIDI格式错误均继承于此"""
+
+    def __init__(self, *args):
+        """音·创库版本的所有MIDI格式错误均继承于此"""
+        super().__init__("MIDI格式错误", *args)
+
+
+class MidiDestroyedError(MSCTBaseException):
+    """Midi文件损坏"""
+
+    def __init__(self, *args):
+        """Midi文件损坏"""
+        super().__init__("MIDI文件损坏：无法读取MIDI文件", *args)
+
+
+class CommandFormatError(RuntimeError):
+    """指令格式与目标格式不匹配而引起的错误"""
+
+    def __init__(self, *args):
+        """指令格式与目标格式不匹配而引起的错误"""
+        super().__init__("指令格式不匹配", *args)
+
+
+class CrossNoteError(MidiFormatException):
+    """同通道下同音符交叉出现所产生的错误"""
+
+    def __init__(self, *args):
+        """同通道下同音符交叉出现所产生的错误"""
+        super().__init__("同通道下同音符交叉", *args)
+
+
+class NotDefineTempoError(MidiFormatException):
+    """没有Tempo设定导致时间无法计算的错误"""
+
+    def __init__(self, *args):
+        """没有Tempo设定导致时间无法计算的错误"""
+        super().__init__("在曲目开始时没有声明Tempo（未指定拍长）", *args)
+
+
+class ChannelOverFlowError(MidiFormatException):
+    """一个midi中含有过多的通道"""
+
+    def __init__(self, max_channel=16, *args):
+        """一个midi中含有过多的通道"""
+        super().__init__("含有过多的通道（数量应≤{}）".format(max_channel), *args)
+
+
+class NotDefineProgramError(MidiFormatException):
+    """没有Program设定导致没有乐器可以选择的错误"""
+
+    def __init__(self, *args):
+        """没有Program设定导致没有乐器可以选择的错误"""
+        super().__init__("未指定演奏乐器", *args)
+
+
+class ZeroSpeedError(MidiFormatException):
+    """以0作为播放速度的错误"""
+
+    def __init__(self, *args):
+        """以0作为播放速度的错误"""
+        super().__init__("播放速度为0", *args)

Musicreater/instConstants.py

@@ -0,0 +1,219 @@
+pitched_instrument_list = {
+    0: ("note.harp", 6),
+    1: ("note.harp", 6),
+    2: ("note.pling", 6),
+    3: ("note.harp", 6),
+    4: ("note.pling", 6),
+    5: ("note.pling", 6),
+    6: ("note.harp", 6),
+    7: ("note.harp", 6),
+    8: ("note.share", 7),  # 打击乐器无音域
+    9: ("note.harp", 6),
+    10: ("note.didgeridoo", 8),
+    11: ("note.harp", 6),
+    12: ("note.xylophone", 4),
+    13: ("note.chime", 4),
+    14: ("note.harp", 6),
+    15: ("note.harp", 6),
+    16: ("note.bass", 8),
+    17: ("note.harp", 6),
+    18: ("note.harp", 6),
+    19: ("note.harp", 6),
+    20: ("note.harp", 6),
+    21: ("note.harp", 6),
+    22: ("note.harp", 6),
+    23: ("note.guitar", 7),
+    24: ("note.guitar", 7),
+    25: ("note.guitar", 7),
+    26: ("note.guitar", 7),
+    27: ("note.guitar", 7),
+    28: ("note.guitar", 7),
+    29: ("note.guitar", 7),
+    30: ("note.guitar", 7),
+    31: ("note.bass", 8),
+    32: ("note.bass", 8),
+    33: ("note.bass", 8),
+    34: ("note.bass", 8),
+    35: ("note.bass", 8),
+    36: ("note.bass", 8),
+    37: ("note.bass", 8),
+    38: ("note.bass", 8),
+    39: ("note.bass", 8),
+    40: ("note.harp", 6),
+    41: ("note.harp", 6),
+    42: ("note.harp", 6),
+    43: ("note.harp", 6),
+    44: ("note.iron_xylophone", 6),
+    45: ("note.guitar", 7),
+    46: ("note.harp", 6),
+    47: ("note.harp", 6),
+    48: ("note.guitar", 7),
+    49: ("note.guitar", 7),
+    50: ("note.bit", 6),
+    51: ("note.bit", 6),
+    52: ("note.harp", 6),
+    53: ("note.harp", 6),
+    54: ("note.bit", 6),
+    55: ("note.flute", 5),
+    56: ("note.flute", 5),
+    57: ("note.flute", 5),
+    58: ("note.flute", 5),
+    59: ("note.flute", 5),
+    60: ("note.flute", 5),
+    61: ("note.flute", 5),
+    62: ("note.flute", 5),
+    63: ("note.flute", 5),
+    64: ("note.bit", 6),
+    65: ("note.bit", 6),
+    66: ("note.bit", 6),
+    67: ("note.bit", 6),
+    68: ("note.flute", 5),
+    69: ("note.harp", 6),
+    70: ("note.harp", 6),
+    71: ("note.flute", 5),
+    72: ("note.flute", 5),
+    73: ("note.flute", 5),
+    74: ("note.harp", 6),
+    75: ("note.flute", 5),
+    76: ("note.harp", 6),
+    77: ("note.harp", 6),
+    78: ("note.harp", 6),
+    79: ("note.harp", 6),
+    80: ("note.bit", 6),
+    81: ("note.bit", 6),
+    82: ("note.bit", 6),
+    83: ("note.bit", 6),
+    84: ("note.bit", 6),
+    85: ("note.bit", 6),
+    86: ("note.bit", 6),
+    87: ("note.bit", 6),
+    88: ("note.bit", 6),
+    89: ("note.bit", 6),
+    90: ("note.bit", 6),
+    91: ("note.bit", 6),
+    92: ("note.bit", 6),
+    93: ("note.bit", 6),
+    94: ("note.bit", 6),
+    95: ("note.bit", 6),
+    96: ("note.bit", 6),
+    97: ("note.bit", 6),
+    98: ("note.bit", 6),
+    99: ("note.bit", 6),
+    100: ("note.bit", 6),
+    101: ("note.bit", 6),
+    102: ("note.bit", 6),
+    103: ("note.bit", 6),
+    104: ("note.harp", 6),
+    105: ("note.banjo", 6),
+    106: ("note.harp", 6),
+    107: ("note.harp", 6),
+    108: ("note.harp", 6),
+    109: ("note.harp", 6),
+    110: ("note.harp", 6),
+    111: ("note.guitar", 7),
+    112: ("note.harp", 6),
+    113: ("note.bell", 4),
+    114: ("note.harp", 6),
+    115: ("note.cow_bell", 5),
+    116: ("note.bd", 7),  # 打击乐器无音域
+    117: ("note.bass", 8),
+    118: ("note.bit", 6),
+    119: ("note.bd", 7),  # 打击乐器无音域
+    120: ("note.guitar", 7),
+    121: ("note.harp", 6),
+    122: ("note.harp", 6),
+    123: ("note.harp", 6),
+    124: ("note.harp", 6),
+    125: ("note.hat", 7),  # 打击乐器无音域
+    126: ("note.bd", 7),  # 打击乐器无音域
+    127: ("note.snare", 7),  # 打击乐器无音域
+}
+
+percussion_instrument_list = {
+    34: ("note.bd", 7),
+    35: ("note.bd", 7),
+    36: ("note.hat", 7),
+    37: ("note.snare", 7),
+    38: ("note.snare", 7),
+    39: ("note.snare", 7),
+    40: ("note.hat", 7),
+    41: ("note.snare", 7),
+    42: ("note.hat", 7),
+    43: ("note.snare", 7),
+    44: ("note.snare", 7),
+    45: ("note.bell", 4),
+    46: ("note.snare", 7),
+    47: ("note.snare", 7),
+    48: ("note.bell", 4),
+    49: ("note.hat", 7),
+    50: ("note.bell", 4),
+    51: ("note.bell", 4),
+    52: ("note.bell", 4),
+    53: ("note.bell", 4),
+    54: ("note.bell", 4),
+    55: ("note.bell", 4),
+    56: ("note.snare", 7),
+    57: ("note.hat", 7),
+    58: ("note.chime", 4),
+    59: ("note.iron_xylophone", 6),
+    60: ("note.bd", 7),
+    61: ("note.bd", 7),
+    62: ("note.xylophone", 4),
+    63: ("note.xylophone", 4),
+    64: ("note.xylophone", 4),
+    65: ("note.hat", 7),
+    66: ("note.bell", 4),
+    67: ("note.bell", 4),
+    68: ("note.hat", 7),
+    69: ("note.hat", 7),
+    70: ("note.flute", 5),
+    71: ("note.flute", 5),
+    72: ("note.hat", 7),
+    73: ("note.hat", 7),
+    74: ("note.xylophone", 4),
+    75: ("note.hat", 7),
+    76: ("note.hat", 7),
+    77: ("note.xylophone", 4),
+    78: ("note.xylophone", 4),
+    79: ("note.bell", 4),
+    80: ("note.bell", 4),
+}
+
+instrument_to_blocks_list = {
+    "note.bass": ("planks",),
+    "note.snare": ("sand",),
+    "note.hat": ("glass",),
+    "note.bd": ("stone",),
+    "note.bell": ("gold_block",),
+    "note.flute": ("clay",),
+    "note.chime": ("packed_ice",),
+    "note.guitar": ("wool",),
+    "note.xylobone": ("bone_block",),
+    "note.iron_xylophone": ("iron_block",),
+    "note.cow_bell": ("soul_sand",),
+    "note.didgeridoo": ("pumpkin",),
+    "note.bit": ("emerald_block",),
+    "note.banjo": ("hay_block",),
+    "note.pling": ("glowstone",),
+    "note.bassattack": ("command_block",),  # 无法找到此音效
+    "note.harp": ("glass",),
+}
+
+nbs_instrument_to_name = {
+    0: "Piano",  # (air)
+    1: "Double Bass",  # (Wood)
+    2: "Bass Drum",  # (Stone)
+    3: "Snare Drum",  # (Sand)
+    4: "Click",  # (Glass)
+    5: "Guitar",  # (Wool)
+    6: "Flute",  # (Clay)
+    7: "Bell",  # (Block of Gold)
+    8: "Chime",  # (Packed Ice)
+    9: "Xylophone",  # (Bone Block)
+    10: "Iron Xylophone",  # (Iron Block)
+    11: "Cow Bell",  # (Soul Sand)
+    12: "Didgeridoo",  # (Pumpkin)
+    13: "Bit",  # (Block of Emerald)
+    14: "Banjo",  # (Hay)
+    15: "Pling",  # (Glowstone)
+}

Musicreater/magicmain.py

@@ -0,0 +1,305 @@
+# -*- coding: utf-8 -*-
+"""
+功能测试 若非已知 请勿更改
+此文件仅供功能测试，并非实际调用的文件
+请注意，此处的文件均为测试使用
+不要更改 不要更改 不要更改
+请注意这里的一切均需要其原作者更改
+这里用于放置一些新奇的点子
+用于测试
+不要更改 不要更改 不要更改！
+"""
+
+# 音·创 开发交流群 861684859
+# Email TriM-Organization@hotmail.com
+# 版权所有 金羿("Eilles Wan") & 诸葛亮与八卦阵("bgArray") & 鸣凤鸽子("MingFengPigeon")
+# 若需转载或借鉴 许可声明请查看仓库目录下的 License.md
+
+
+"""
+音·创 (Musicreater)
+是一款免费开源的针对《我的世界》的midi音乐转换库
+Musicreater (音·创)
+A free open source library used for convert midi file into formats that is suitable for **Minecraft**.
+
+版权所有 © 2023 音·创 开发者
+Copyright © 2023 all the developers of Musicreater
+
+开源相关声明请见 ../License.md
+Terms & Conditions: ../License.md
+"""
+
+
+
+
+
+def _toCmdList_m1(
+        self,
+        scoreboardname: str = "mscplay",
+        volume: float = 1.0,
+        speed: float = 1.0) -> list:
+    """
+    使用Dislink Sforza的转换思路，将midi转换为我的世界命令列表
+    :param scoreboardname: 我的世界的计分板名称
+    :param volume: 音量，注意：这里的音量范围为(0,1]，如果超出将被处理为正确值，其原理为在距离玩家 (1 / volume -1) 的地方播放音频
+    :param speed: 速度，注意：这里的速度指的是播放倍率，其原理为在播放音频的时候，每个音符的播放时间除以 speed
+    :return: tuple(命令列表, 命令个数, 计分板最大值)
+    """
+    tracks = []
+    if volume > 1:
+        volume = 1
+    if volume <= 0:
+        volume = 0.001
+
+    commands = 0
+    maxscore = 0
+
+    for i, track in enumerate(self.midi.tracks):
+
+        ticks = 0
+        instrumentID = 0
+        singleTrack = []
+
+        for msg in track:
+            ticks += msg.time
+            # print(msg)
+            if msg.is_meta:
+                if msg.type == "set_tempo":
+                    tempo = msg.tempo
+            else:
+                if msg.type == "program_change":
+                    # print("TT")
+                    instrumentID = msg.program
+                if msg.type == "note_on" and msg.velocity != 0:
+                    nowscore = round(
+                        (ticks * tempo)
+                        / ((self.midi.ticks_per_beat * float(speed)) * 50000)
+                    )
+                    maxscore = max(maxscore, nowscore)
+                    soundID, _X = self.__Inst2soundID_withX(instrumentID)
+                    singleTrack.append(
+                        "execute @a[scores={" +
+                        str(scoreboardname) +
+                        "=" +
+                        str(nowscore) +
+                        "}" +
+                        f"] ~ ~ ~ playsound {soundID} @s ~ ~{1 / volume - 1} ~ {msg.velocity * (0.7 if msg.channel == 0 else 0.9)} {2 ** ((msg.note - 60 - _X) / 12)}")
+                    commands += 1
+        if len(singleTrack) != 0:
+            tracks.append(singleTrack)
+
+    return [tracks, commands, maxscore]
+
+
+
+
+
+# ============================
+
+
+
+
+import mido
+
+class NoteMessage:
+    def __init__(self, channel, pitch, velocity, startT, lastT, midi, now_bpm, change_bpm=None):
+        self.channel = channel
+        self.note = pitch
+        self.velocity = velocity
+        self.startTime = startT
+        self.lastTime = lastT
+        self.tempo = now_bpm  # 这里要程序实现获取bpm可以参考我的程序
+
+        def mt2gt(mt, tpb_a, bpm_a):
+            return mt / tpb_a / bpm_a * 60
+        self.startTrueTime = mt2gt(self.startTime, midi.ticks_per_beat, self.tempo)  # / 20
+        # delete_extra_zero(round_up())
+        if change_bpm is not None:
+            self.lastTrueTime = mt2gt(self.lastTime, midi.ticks_per_beat, change_bpm)  # / 20
+        else:
+            self.lastTrueTime = mt2gt(self.lastTime, midi.ticks_per_beat, self.tempo)  # / 20
+        # delete_extra_zero(round_up())
+        print((self.startTime * self.tempo) / (midi.ticks_per_beat * 50000))
+
+    def __str__(self):
+        return "noteMessage channel=" + str(self.channel) + " note=" + str(self.note) + " velocity=" + \
+               str(self.velocity) + " startTime=" + str(self.startTime) + " lastTime=" + str(self.lastTime) + \
+               " startTrueTime=" + str(self.startTrueTime) + " lastTrueTime=" + str(self.lastTrueTime)
+
+
+def load(mid: mido.MidiFile):
+
+    type_ = [False, False, False]  # note_off / note_on+0 / mixed
+
+    is_tempo = False
+
+    # 预检
+    for i, track in enumerate(mid.tracks):
+        for msg in track:
+            # print(msg)
+            if msg.is_meta is not True:
+                if msg.type == 'note_on' and msg.velocity == 0:
+                    type_[1] = True
+                elif msg.type == "note_off":
+                    type_[0] = True
+            if msg.is_meta is True and msg.type == "set_tempo":
+                is_tempo = True
+
+    if is_tempo is not True:
+        raise Exception("这个mid没有可供计算时间的tempo事件")
+
+    if type_[0] is True and type_[1] is True:
+        type_[2] = True
+        type_[1] = False
+        type_[0] = False
+    print(type_)
+
+    bpm = 0
+    recent_change_bpm = 0
+    is_change_bpm = False
+    # 实检
+    for i, track in enumerate(mid.tracks):
+        noteOn = []
+        trackS = []
+        ticks = 0
+        for msg in track:
+            print(msg)
+            ticks += msg.time
+            print(ticks)
+            if msg.is_meta is True and msg.type == "set_tempo":
+                recent_change_bpm = bpm
+                bpm =  60000000 / msg.tempo
+                is_change_bpm = True
+
+            if msg.type == 'note_on' and msg.velocity != 0:
+                noteOn.append([msg, msg.note, ticks])
+            if type_[1] is True:
+                if msg.type == 'note_on' and msg.velocity == 0:
+                    for u in noteOn:
+                        index = 0
+                        if u[1] == msg.note:
+                            lastMessage = u[0]
+                            lastTick = u[2]
+                            break
+                        index += 1
+                    print(lastTick)
+                    if is_change_bpm and recent_change_bpm != 0:
+                        trackS.append(NoteMessage(msg.channel, msg.note, lastMessage.velocity, lastTick, ticks - lastTick,
+                                                  mid, recent_change_bpm, bpm))
+                        is_change_bpm = False
+                    else:
+                        trackS.append(
+                            NoteMessage(msg.channel, msg.note, lastMessage.velocity, lastTick, ticks - lastTick,
+                                        mid, bpm))
+                    # print(noteOn)
+                    # print(index)
+                    try:
+                        noteOn.pop(index)
+                    except IndexError:
+                        noteOn.pop(index - 1)
+        print(trackS)
+        for j in trackS:
+            print(j)
+
+
+if __name__ == '__main__':
+    load(mido.MidiFile("test.mid"))
+
+
+
+
+# ============================
+
+
+from typing import Union
+from .utils import x,y,z,bottem_side_length_of_smallest_square_bottom_box,form_note_block_in_NBT_struct,form_repeater_in_NBT_struct
+
+# 不要用 没写完
+def delay_to_note_blocks(
+    baseblock: str = "stone", 
+    position_forward: Union(x, y, z) = z,
+    max_height: int = 64,
+):
+    """传入音符，生成以音符盒存储的红石音乐
+    :param:
+        baseblock: 中继器的下垫方块
+        position_forward: 结构延长方向
+    :return 是否生成成功
+    """
+
+    from TrimMCStruct import Structure, Block
+
+    _sideLength = bottem_side_length_of_smallest_square_bottom_box(
+        len(commands), max_height
+    )
+
+    struct = Structure(
+        (_sideLength, max_height, _sideLength),  # 声明结构大小
+    )
+
+    log = print
+
+    startpos = [0,0,0]
+
+
+    # 1拍 x 2.5 rt
+    def placeNoteBlock():
+        for i in notes:
+            error = True
+            try:
+                struct.set_block(
+                    [startpos[0], startpos[1] + 1, startpos[2]],
+                    form_note_block_in_NBT_struct(height2note[i[0]], instrument),
+                )
+                struct.set_block(startpos, Block("universal_minecraft", instuments[i[0]][1]),)
+                error = False
+            except ValueError:
+                log("无法放置音符：" + str(i) + "于" + str(startpos))
+                struct.set_block(Block("universal_minecraft", baseblock), startpos)
+                struct.set_block(
+                    Block("universal_minecraft", baseblock),
+                    [startpos[0], startpos[1] + 1, startpos[2]],
+                )
+            finally:
+                if error is True:
+                    log("无法放置音符：" + str(i) + "于" + str(startpos))
+                    struct.set_block(Block("universal_minecraft", baseblock), startpos)
+                    struct.set_block(
+                        Block("universal_minecraft", baseblock),
+                        [startpos[0], startpos[1] + 1, startpos[2]],
+                    )
+            delay = int(i[1] * speed + 0.5)
+            if delay <= 4:
+                startpos[0] += 1
+                struct.set_block(
+                    form_repeater_in_NBT_struct(delay, "west"),
+                    [startpos[0], startpos[1] + 1, startpos[2]],
+                )
+                struct.set_block(Block("universal_minecraft", baseblock), startpos)
+            else:
+                for j in range(int(delay / 4)):
+                    startpos[0] += 1
+                    struct.set_block(
+                        form_repeater_in_NBT_struct(4, "west"),
+                        [startpos[0], startpos[1] + 1, startpos[2]],
+                    )
+                    struct.set_block(Block("universal_minecraft", baseblock), startpos)
+                if delay % 4 != 0:
+                    startpos[0] += 1
+                    struct.set_block(
+                        form_repeater_in_NBT_struct(delay % 4, "west"),
+                        [startpos[0], startpos[1] + 1, startpos[2]],
+                    )
+                    struct.set_block(Block("universal_minecraft", baseblock), startpos)
+            startpos[0] += posadder[0]
+            startpos[1] += posadder[1]
+            startpos[2] += posadder[2]
+
+    # e = True
+    try:
+        placeNoteBlock()
+        # e = False
+    except:  # ValueError
+        log("无法放置方块了，可能是因为区块未加载叭")
+
+

Musicreater/utils.py

@@ -0,0 +1,459 @@
+import math
+import os
+
+bdx_key = {
+    "x": [b"\x0f", b"\x0e", b"\x1c", b"\x14", b"\x15"],
+    "y": [b"\x11", b"\x10", b"\x1d", b"\x16", b"\x17"],
+    "z": [b"\x13", b"\x12", b"\x1e", b"\x18", b"\x19"],
+}
+"""key存储了方块移动指令的数据，其中可以用key[x|y|z][0|1]来表示xyz的减或增
+而key[][2+]是用来增加指定数目的"""
+
+x = "x"
+y = "y"
+z = "z"
+
+
+def bdx_move(axis: str, value: int):
+    if value == 0:
+        return b""
+    if abs(value) == 1:
+        return bdx_key[axis][0 if value == -1 else 1]
+
+    pointer = sum(
+        [
+            1 if i else 0
+            for i in (
+            value != -1,
+            value < -1 or value > 1,
+            value < -128 or value > 127,
+            value < -32768 or value > 32767,
+        )
+        ]
+    )
+
+    return bdx_key[axis][pointer] + value.to_bytes(
+        2 ** (pointer - 2), "big", signed=True
+    )
+
+
+def compress_zipfile(sourceDir, outFilename, compression=8, exceptFile=None):
+    """使用compression指定的算法打包目录为zip文件\n
+    默认算法为DEFLATED(8),可用算法如下：\n
+    STORED = 0\n
+    DEFLATED = 8\n
+    BZIP2 = 12\n
+    LZMA = 14\n
+    """
+    import zipfile
+
+    zipf = zipfile.ZipFile(outFilename, "w", compression)
+    pre_len = len(os.path.dirname(sourceDir))
+    for parent, dirnames, filenames in os.walk(sourceDir):
+        for filename in filenames:
+            if filename == exceptFile:
+                continue
+            pathfile = os.path.join(parent, filename)
+            arc_name = pathfile[pre_len:].strip(os.path.sep)  # 相对路径
+            zipf.write(pathfile, arc_name)
+    zipf.close()
+
+
+def form_command_block_in_BDX_bytes(
+        command: str,
+        particularValue: int,
+        impluse: int = 0,
+        condition: bool = False,
+        needRedstone: bool = True,
+        tickDelay: int = 0,
+        customName: str = "",
+        executeOnFirstTick: bool = False,
+        trackOutput: bool = True,
+):
+    """
+    使用指定项目返回指定的指令方块放置指令项
+    :param command: `str`
+        指令
+    :param particularValue:
+        方块特殊值，即朝向
+            :0	下	无条件
+            :1	上	无条件
+            :2	z轴负方向	无条件
+            :3	z轴正方向	无条件
+            :4	x轴负方向	无条件
+            :5	x轴正方向	无条件
+            :6	下	无条件
+            :7	下	无条件
+
+            :8	下	有条件
+            :9	上	有条件
+            :10	z轴负方向	有条件
+            :11	z轴正方向	有条件
+            :12	x轴负方向	有条件
+            :13	x轴正方向	有条件
+            :14	下	有条件
+            :14	下	有条件
+        注意！此处特殊值中的条件会被下面condition参数覆写
+    :param impluse: `int 0|1|2`
+        方块类型
+            0脉冲 1循环 2连锁
+    :param condition: `bool`
+        是否有条件
+    :param needRedstone: `bool`
+        是否需要红石
+    :param tickDelay: `int`
+        执行延时
+    :param customName: `str`
+        悬浮字
+    lastOutput: `str`
+        上次输出字符串，注意此处需要留空
+    :param executeOnFirstTick: `bool`
+        首刻执行(循环指令方块是否激活后立即执行，若为False，则从激活时起延迟后第一次执行)
+    :param trackOutput: `bool`
+        是否输出
+
+    :return:str
+    """
+    block = b"\x24" + particularValue.to_bytes(2, byteorder="big", signed=False)
+
+    for i in [
+        impluse.to_bytes(4, byteorder="big", signed=False),
+        bytes(command, encoding="utf-8") + b"\x00",
+        bytes(customName, encoding="utf-8") + b"\x00",
+        bytes("", encoding="utf-8") + b"\x00",
+        tickDelay.to_bytes(4, byteorder="big", signed=True),
+        executeOnFirstTick.to_bytes(1, byteorder="big"),
+        trackOutput.to_bytes(1, byteorder="big"),
+        condition.to_bytes(1, byteorder="big"),
+        needRedstone.to_bytes(1, byteorder="big"),
+    ]:
+        block += i
+    return block
+
+
+def bottem_side_length_of_smallest_square_bottom_box(total: int, maxHeight: int):
+    """给定总方块数量和最大高度，返回所构成的图形外切正方形的边长
+    :param total: 总方块数量
+    :param maxHeight: 最大高度
+    :return: 外切正方形的边长 int"""
+    return math.ceil(math.sqrt(math.ceil(total / maxHeight)))
+
+
+def commands_to_BDX_bytes(
+        commands: list,
+        max_height: int = 64,
+):
+    """
+    :param commands: 指令列表(指令, 延迟)
+    :param max_height: 生成结构最大高度
+    :return 成功与否，成功返回(True,未经过压缩的源,结构占用大小)，失败返回(False,str失败原因)
+    """
+
+    _sideLength = bottem_side_length_of_smallest_square_bottom_box(
+        len(commands), max_height
+    )
+    _bytes = b""
+
+    y_forward = True
+    z_forward = True
+
+    now_y = 0
+    now_z = 0
+    now_x = 0
+
+    for cmd, delay in commands:
+        impluse = 2
+        condition = False
+        needRedstone = False
+        tickDelay = delay
+        customName = ""
+        executeOnFirstTick = False
+        trackOutput = True
+        _bytes += form_command_block_in_BDX_bytes(
+            cmd,
+            (1 if y_forward else 0)
+            if (
+                    ((now_y != 0) and (not y_forward))
+                    or (y_forward and (now_y != (max_height - 1)))
+            )
+            else (3 if z_forward else 2)
+            if (
+                    ((now_z != 0) and (not z_forward))
+                    or (z_forward and (now_z != _sideLength - 1))
+            )
+            else 5,
+            impluse=impluse,
+            condition=condition,
+            needRedstone=needRedstone,
+            tickDelay=tickDelay,
+            customName=customName,
+            executeOnFirstTick=executeOnFirstTick,
+            trackOutput=trackOutput,
+        )
+
+        now_y += 1 if y_forward else -1
+
+        if ((now_y >= max_height) and y_forward) or ((now_y < 0) and (not y_forward)):
+            now_y -= 1 if y_forward else -1
+
+            y_forward = not y_forward
+
+            now_z += 1 if z_forward else -1
+
+            if ((now_z >= _sideLength) and z_forward) or (
+                    (now_z < 0) and (not z_forward)
+            ):
+                now_z -= 1 if z_forward else -1
+                z_forward = not z_forward
+                _bytes += bdx_key[x][1]
+                now_x += 1
+            else:
+                _bytes += bdx_key[z][int(z_forward)]
+
+        else:
+            _bytes += bdx_key[y][int(y_forward)]
+
+    return (
+        _bytes,
+        [
+            now_x + 1,
+            max_height if now_x or now_z else now_y,
+            _sideLength if now_x else now_z,
+        ],
+        [now_x, now_y, now_z],
+    )
+
+
+def form_note_block_in_NBT_struct(
+        note: int, coordinate: tuple, instrument: str = "note.harp", powered: bool = False
+):
+    """生成音符盒方块
+    :param note: `int`(0~24)
+        音符的音高
+    :param coordinate: `tuple[int,int,int]`
+        此方块所在之相对坐标
+    :param instrument: `str`
+        音符盒的乐器
+    :param powered: `bool`
+        是否已被激活
+    :return Block
+    """
+
+    from TrimMCStruct import Block, TAG_Byte
+    return Block(
+        "minecraft",
+        "noteblock",
+        {
+            "instrument": instrument.replace("note.", ""),
+            "note": note,
+            "powered": powered,
+        },
+        {
+            "block_entity_data": {
+                "note": TAG_Byte(note),
+                "id": "noteblock",
+                "x": coordinate[0],
+                "y": coordinate[1],
+                "z": coordinate[2],
+            }
+        },
+    )
+
+
+def form_repeater_in_NBT_struct(
+        delay: int, facing: int
+):
+    """生成中继器方块
+    :param facing:
+    :param delay: 1~4
+    :return Block()"""
+
+    from TrimMCStruct import Block
+
+    return Block(
+        "minecraft",
+        "unpowered_repeater",
+        {
+            "repeater_delay": delay,
+            "direction": facing,
+        },
+    )
+
+
+def form_command_block_in_NBT_struct(
+        command: str,
+        coordinate: tuple,
+        particularValue: int,
+        impluse: int = 0,
+        condition: bool = False,
+        alwaysRun: bool = True,
+        tickDelay: int = 0,
+        customName: str = "",
+        executeOnFirstTick: bool = False,
+        trackOutput: bool = True,
+):
+    """
+    使用指定项目返回指定的指令方块结构
+    :param command: `str`
+        指令
+    :param coordinate: `tuple[int,int,int]`
+        此方块所在之相对坐标
+    :param particularValue:
+        方块特殊值，即朝向
+            :0	下	无条件
+            :1	上	无条件
+            :2	z轴负方向	无条件
+            :3	z轴正方向	无条件
+            :4	x轴负方向	无条件
+            :5	x轴正方向	无条件
+            :6	下	无条件
+            :7	下	无条件
+
+            :8	下	有条件
+            :9	上	有条件
+            :10	z轴负方向	有条件
+            :11	z轴正方向	有条件
+            :12	x轴负方向	有条件
+            :13	x轴正方向	有条件
+            :14	下	有条件
+            :14	下	有条件
+        注意！此处特殊值中的条件会被下面condition参数覆写
+    :param impluse: `int 0|1|2`
+        方块类型
+            0脉冲 1循环 2连锁
+    :param condition: `bool`
+        是否有条件
+    :param alwaysRun: `bool`
+        是否始终执行
+    :param tickDelay: `int`
+        执行延时
+    :param customName: `str`
+        悬浮字
+    :param executeOnFirstTick: `bool`
+        首刻执行(循环指令方块是否激活后立即执行，若为False，则从激活时起延迟后第一次执行)
+    :param trackOutput: `bool`
+        是否输出
+
+    :return:str
+    """
+
+    from TrimMCStruct import Block, TAG_Long
+
+    return Block(
+        "minecraft",
+        "command_block"
+        if impluse == 0
+        else ("repeating_command_block" if impluse == 1 else "chain_command_block"),
+        states={"conditional_bit": condition, "facing_direction": particularValue},
+        extra_data={
+            "block_entity_data": {
+                "Command": command,
+                "CustomName": customName,
+                "ExecuteOnFirstTick": executeOnFirstTick,
+                "LPCommandMode": 0,
+                "LPCondionalMode": False,
+                "LPRedstoneMode": False,
+                "LastExecution": TAG_Long(0),
+                "LastOutput": "",
+                "LastOutputParams": [],
+                "SuccessCount": 0,
+                "TickDelay": tickDelay,
+                "TrackOutput": trackOutput,
+                "Version": 25,
+                "auto": alwaysRun,
+                "conditionMet": False,  # 是否已经满足条件
+                "conditionalMode": condition,
+                "id": "CommandBlock",
+                "isMovable": True,
+                "powered": False,  # 是否已激活
+                "x": coordinate[0],
+                "y": coordinate[1],
+                "z": coordinate[2],
+            }
+        },
+        compability_version=17959425,
+    )
+
+
+def commands_to_structure(
+        commands: list,
+        max_height: int = 64,
+):
+    """
+    :param commands: 指令列表(指令, 延迟)
+    :param max_height: 生成结构最大高度
+    :return 成功与否，成功返回(结构类,结构占用大小)，失败返回(False,str失败原因)
+    """
+
+    from TrimMCStruct import Structure
+
+    _sideLength = bottem_side_length_of_smallest_square_bottom_box(
+        len(commands), max_height
+    )
+
+    struct = Structure(
+        (_sideLength, max_height, _sideLength),  # 声明结构大小
+    )
+
+    y_forward = True
+    z_forward = True
+
+    now_y = 0
+    now_z = 0
+    now_x = 0
+
+    for cmd, delay in commands:
+        coordinate = (now_x, now_y, now_z)
+        struct.set_block(
+            coordinate,
+            form_command_block_in_NBT_struct(
+                command=cmd,
+                coordinate=coordinate,
+                particularValue=(1 if y_forward else 0)
+                if (
+                        ((now_y != 0) and (not y_forward))
+                        or (y_forward and (now_y != (max_height - 1)))
+                )
+                else (
+                    (3 if z_forward else 2)
+                    if (
+                            ((now_z != 0) and (not z_forward))
+                            or (z_forward and (now_z != _sideLength - 1))
+                    )
+                    else 5
+                ),
+                impluse=2,
+                condition=False,
+                alwaysRun=True,
+                tickDelay=delay,
+                customName="",
+                executeOnFirstTick=False,
+                trackOutput=True,
+            ),
+        )
+
+        now_y += 1 if y_forward else -1
+
+        if ((now_y >= max_height) and y_forward) or ((now_y < 0) and (not y_forward)):
+            now_y -= 1 if y_forward else -1
+
+            y_forward = not y_forward
+
+            now_z += 1 if z_forward else -1
+
+            if ((now_z >= _sideLength) and z_forward) or (
+                    (now_z < 0) and (not z_forward)
+            ):
+                now_z -= 1 if z_forward else -1
+                z_forward = not z_forward
+                now_x += 1
+
+    return (
+        struct,
+        (
+            now_x + 1,
+            max_height if now_x or now_z else now_y,
+            _sideLength if now_x else now_z,
+        ),
+        (now_x, now_y, now_z),
+    )

README.md

@@ -1,104 +1,133 @@
-# 音·创 Musicreater
 
-### 介绍
-音·创 Musicreater 是由金羿(*W-YI*)开发的一款 **《我的世界：基岩版》** 音乐生成辅助软件
+<h1 align="center">
+    音·创 Musicreater
+</h1>
 
-欢迎加群：861684859
+<p align="center">
+    <img width="128" height="128" src="https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.ico">
+    </img>
+</p>
 
-### 作者
+<h3 align="center">一款免费开源的 《我的世界》 MIDI音乐转换库。</h3>
 
-金羿 (Eilles)：主要作者，开发了音·创主体，及其前身“函数音乐生成器”、“世界音创”。
-
-bgArray “诸葛亮与八卦阵”：修复bug，改进代码美观度，增加新功能，更改数据格式等。
-
-### 软件架构
-
-软件采用 *Python* 作为第一语言，目前还没有使用其他语言辅助。使用 *Tkinter* 为图形库。
-
-支持 Windows7+ 以及各个支持 Python3.8 的 Linux
-
-***各位开发人员注意！！！多语言支持请使用`READABLETEXT`常量输出文字！！！如需补充，请在简体中文的语言文件(zhCN.py)中补充！！！***
+<p align="center">
+    <img src="https://forthebadge.com/images/badges/built-with-love.svg">
+    <a href='https://gitee.com/TriM-Organization/Musicreater'>
+        <img align="right" src='https://gitee.com/TriM-Organization/Musicreater/widgets/widget_1.svg' alt='Fork me on Gitee'>
+        </img>
+    </a>
+<p>
 
 
-### 安装教程
-
-正在到来。
-
-### 从源代码运行教程
-
-#### Windows7+
-
-0.  [Gitee下载（需要登陆）](https://gitee.com/EillesWan/Musicreater/repository/archive/master.zip)
-    [Github下载（慢）](https://github.com/EillesWan/Musicreater/archive/refs/heads/master.zip)本程序源代码
-1.  安装Python 3.8.10 
-    [下载64位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
-    [下载32位Python安装包](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
-2.  以管理员身份运行 补全库.py :
-    -   点击 “开始” 菜单，搜索 `命令提示符`
-    -   右键点击 `命令提示符` 左键点击 “以管理员身份运行”
-    -   将 “补全库.py” 拖拽入开启的窗口，按下回车
-3.  等待安装完成后，双击运行 Musicreater.py
-
-#### Linux
-
-0.  若你没有足够优秀的环境，推荐先在终端敲：
-```bash
-sudo apt-get update
-sudo apt-get upgrade
-sudo apt-get install python3
-sudo apt-get install python3-pip
-sudo apt-get install git
-```
-1.  若你足够自信，该整的都整了，就在你想下载此程序的地方打开终端，敲：
-```bash
-sudo git clone https://gitee.com/EillesWan/Musicreater.git
-cd Musicreater
-python3 补全库.py
-python3 Musicreater.py
-```
 
 
-### 使用说明
 
-1.  直接运行就好
-2.  看得懂简体中文字的不一定全会用
-3.  最好要懂一点点英文
+[![][Bilibili: 金羿ELS]](https://space.bilibili.com/397369002/)
+[![][Bilibili: 诸葛亮与八卦阵]](https://space.bilibili.com/604072474) 
+[![CodeStyle: black]](https://github.com/psf/black)
+[![][python]](https://www.python.org/)
+[![][license]](LICENSE)
+[![][release]](../../releases)
+
+[![GiteeStar](https://gitee.com/TriM-Organization/Musicreater/badge/star.svg?theme=gray)](https://gitee.com/TriM-Organization/Musicreater/stargazers)
+[![GiteeFork](https://gitee.com/TriM-Organization/Musicreater/badge/fork.svg?theme=gray)](https://gitee.com/TriM-Organization/Musicreater/members)
+[![GitHub Repo stars](https://img.shields.io/github/stars/TriM-Organization/Musicreater?color=white&logo=GitHub&style=plastic)](https://github.com/TriM-Organization/Musicreater/stargazers)
+[![GitHub Repo Forks](https://img.shields.io/github/forks/TriM-Organization/Musicreater?color=white&logo=GitHub&style=plastic)](https://github.com/TriM-Organization/Musicreater/forks)
 
 
-### 诸葛亮与八卦阵的说明（不必要）
-
-1. 首先！这里的提示是给想使用多音色资源包的人的，如果你想用就请下载 [神羽资源包（神羽自己的链接）](https://pan.baidu.com/s/11uoq5zwN7c3rX-98DqVpJg)提取码:ek3t
-2. 下载到你自己电脑上某个位置，可以不放置于本项目下。音色资源包较大，可以选取只下载：
-    `神羽资源包_乐器、音源的资源包\羽音缭绕-midiout_25.0` 这个文件夹，再嫌麻烦的话，也可以只下载其中的：
-    `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\mcpack(国际版推荐)格式_25.0` 或者：
-    `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\zip格式_25.0`
-4. 接下来就是关键了：在*音创*中绑定资源包
-    首先，先打开 *音创*->帮助与疑问->\[神羽资源包位置选择\]：选择文件夹... 这时候，会跳出选择框
-    关键来了，选择：***您下载的`羽音缭绕-midiout_25.0`文件夹，或者`mcpack(国际版推荐)格式_25.0`或`zip格式_25.0`的上级目录***
-    举个例子：我的文件路径是这样的：
-    `L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0`这里面有：`神羽资源包_25.0_使用方法.xls`、
-    `mcpack(国际版推荐)格式_25.0`、`zip格式_25.0`两个文件夹和一个.xls文件，而你在音创中
-    也应该选择这个文件夹：**L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0**
-6. 如果你想使用音色资源包来制作函数，那么解析时你应该用 *音创*->编辑->从midi导入音轨且用新方法解析，
-    然后再使用 *音创*->函数（包）->下面的四个新函数
-
-### 致谢
-
-1.  感谢由 [Fuckcraft](https://github.com/fuckcraft) “鸣凤鸽子”等 带来的我的世界websocket服务器功能
-2.  感谢 昀梦\<QQ1515399885\> 找出指令生成错误bug并指正
-3.  感谢由 Charlie_Ping “查理平” 带来的bdx转换功能
-4.  感谢由 CMA_2401PT 带来的 BDXWorkShop 供本程序对于bdx操作的指导
-5.  感谢由 Miracle Plume “神羽” \<QQshenyu40403\>带来的羽音缭绕基岩版音色资源包
-6.  感谢广大群友为此程序提供的测试等支持
-7.  若您对我们有所贡献但您的名字没有显示在此列表中，请联系我！
+简体中文🇨🇳 | [English🇬🇧](README_EN.md)
 
 
-### 作者\<*金羿*\>(W-YI)联系方式
+## 介绍🚀
 
-1.  QQ       2647547478
-2.  电邮      EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
-3.  微信      WYI_DoctorYI
+音·创 是一个免费开源的针对 **《我的世界》** 的MIDI音乐转换库
 
-### 作者\<*诸葛亮与八卦阵*\>(bgArray) 联系方式
+欢迎加群：[861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
 
-1.  QQ       4740437765
+## 下载安装
+
+- 使用pypi
+    ```bash
+    pip install Musicreater
+    ```
+
+- 如果出现错误，可以尝试：
+    ```bash
+    pip install -i https://pypi.python.org/simple Musicreater
+    ```
+- （对于开发者来说）升级：
+    ```bash
+    pip install -i https://pypi.python.org/simple Musicreater --upgrade
+    ```
+
+- 克隆仓库并安装
+    ```bash
+    git clone https://gitee.com/TriM-Organization/Musicreater.git
+    cd Musicreater
+    python setup.py install
+    ```
+
+以上命令种 `python`、`pip` 请依照各个环境不同灵活更换，可能为`python3`或`pip3`之类。
+
+## 文档📄
+
+[生成文件的使用](./docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)
+
+[仓库API文档](./docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md)
+
+## 作者✒
+
+金羿 Eilles：我的世界基岩版指令师，个人开发者，B站不知名UP主，江西在校高中生。
+
+诸葛亮与八卦阵 bgArray：我的世界基岩版玩家，喜欢编程和音乐，深圳初二学生。
+
+## 致谢🙏
+本致谢列表排名无顺序。
+
+- 感谢 **昀梦**\<QQ1515399885\> 找出指令生成错误bug并指正
+- 感谢由 **Charlie_Ping “查理平”** 带来的BDX文件转换参考，以及MIDI-我的世界对应乐器参考表格
+- 感谢由 **[CMA_2401PT](https://github.com/CMA2401PT)** 为我们的软件开发的一些方面进行指导，同时我们参考了他的BDXworkshop作为BDX结构编辑的参考
+- 感谢由 **[Dislink Sforza](https://github.com/Dislink) “断联·斯福尔扎”**\<QQ1600515314\> 带来的midi音色解析以及转换指令的算法，我们将其改编并应用；同时，感谢他的[网页版转换器](https://dislink.github.io/midi2bdx/)给我们的开发与更新带来巨大的压力和动力，让我们在原本一骑绝尘的摸鱼道路上转向开发，希望他能考上一个理想的大学！
+- 感谢 **Touch “偷吃”**\<QQ1793537164\> 提供的BDX导入测试支持，并对程序的改进提供了丰富的意见；同时也感谢他的不断尝试新的内容，使我们的排错更进一步
+- 感谢 **Mono**\<QQ738893087\> 反馈安装时的问题，辅助我们找到了视窗操作系统下的兼容性问题；感谢其反馈延迟播放器出现的重大问题，让我们得以修改全部延迟播放错误
+- 感谢 **Ammelia “艾米利亚”**\<QQ2838334637\> 敦促我们进行新的功能开发，并为新功能提出了非常优秀的大量建议，以及提供的BDX导入测试支持，为我们的新结构生成算法提供了大量的实际理论支持
+- 感谢 **[神羽](https://gitee.com/snowykami) “[SnowyKami](https://github.com/snowyfirefly)”** 对我们项目的支持与宣传，希望他能考的一所优秀的大学！
+- 感谢 **指令师_苦力怕 playjuice123**\<QQ240667197\>为我们的程序找出错误，并提醒我们修复一个一直存在的大bug。
+- 感谢 **雷霆**\<QQ3555268519\>为我们的程序找出错误，并提醒修复bug。
+
+>	感谢广大群友为此程序提供的测试等支持
+>
+>	若您对我们有所贡献但您的名字没有显示在此列表中，请联系我们！
+
+## 联系📞
+
+若遇到库中的问题，欢迎在[此](https://gitee.com/TriM-Organization/Musicreater/issues/new)提出你的issue。
+
+如果需要与开发组进行交流，欢迎加入我们的[开发闲聊Q群](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)。
+
+--------------------------------------------
+
+此项目并非一个官方 《我的世界》（*Minecraft*）项目
+
+此项目不隶属或关联于 Mojang Studios 或 微软
+
+此项目亦不与 网易 相关
+
+“Minecraft”是 Mojang Synergies AB 的商标，此项目中所有对于“我的世界”、“Minecraft”等相关称呼均为引用性使用
+
+* 上文提及的 网易 公司，指代的是在中国大陆运营《我的世界：中国版》的上海网之易网络科技发展有限公司
+
+NOT AN OFFICIAL MINECRAFT PRODUCT.
+
+NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
+
+
+
+
+
+[Bilibili: 金羿ELS]: https://img.shields.io/badge/Bilibili-%E5%87%8C%E4%BA%91%E9%87%91%E7%BE%BF-00A1E7?style=for-the-badge
+[Bilibili: 诸葛亮与八卦阵]: https://img.shields.io/badge/Bilibili-%E8%AF%B8%E8%91%9B%E4%BA%AE%E4%B8%8E%E5%85%AB%E5%8D%A6%E9%98%B5-00A1E7?style=for-the-badge
+[CodeStyle: black]: https://img.shields.io/badge/code%20style-black-121110.svg?style=for-the-badge
+[python]: https://img.shields.io/badge/python-3.8-AB70FF?style=for-the-badge
+[release]: https://img.shields.io/github/v/release/EillesWan/Musicreater?style=for-the-badge
+[license]: https://img.shields.io/badge/Licence-Apache-228B22?style=for-the-badge

README_EN.md

@@ -0,0 +1,86 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<p align="center">
+<img width="128" height="128" src="https://s1.ax1x.com/2022/05/06/Ouhghj.md.png" >
+</p>
+
+<h3 align="center">a free open-source library of converting midi files into _Minecraft_ formats.</h3>
+
+<p align="center">
+<img src="https://forthebadge.com/images/badges/built-with-love.svg">
+<p>
+
+[![][Bilibili: Eilles]](https://space.bilibili.com/397369002/)
+[![][Bilibili: bgArray]](https://space.bilibili.com/604072474) 
+[![CodeStyle: black]](https://github.com/psf/black)
+![][python]
+[![][license]](LICENSE)
+[![][release]](../../releases)
+
+[简体中文🇨🇳](README.md) | English🇬🇧
+
+**Notice that the language translation of *Musicreater* may be a little SLOW.**
+
+## Introduction🚀
+
+Musicreater is a free open-source library used for converting midi file into formats that could be read in *Minecraft*.
+
+Welcome to join our QQ group: [861684859](https://jq.qq.com/?_wv=1027&k=hpeRxrYr)
+
+## Documentation📄
+
+(Not in English yet)
+
+[生成文件的使用](./docs/%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%9A%84%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)
+
+[仓库API文档](./docs/%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md)
+
+### Authors✒
+
+Eilles (金羿)：A senior high school student, individual developer, unfamous Bilibili UPer, which knows a little about commands in *Minecraft: Bedrock Edition*
+
+bgArray "诸葛亮与八卦阵": A junior high school student, player of *Minecraft: Bedrock Edition*, which is a fan of music and programming.
+
+
+## Thanks🙏
+This list is not in any order.
+
+-   Thank *昀梦*\<QQ1515399885\> for finding and correcting the bugs in the commands that *Musicreater* generated.
+-   Thank *Charlie_Ping “查理平”* for bdx convert function for reference, and the chart that's used to convert the mid's instruments into Minecraft's instruments.
+-   Thank *[CMA_2401PT](https://github.com/CMA2401PT)* for BDXWorkShop for reference of the .bdx structure's operation, and his guidance in some aspects of our development.
+-   Thank *[Dislink Sforza](https://github.com/Dislink) “断联·斯福尔扎”* \<QQ1600515314\> for his midi analysis algorithm brought to us, we had adapted it and made it applied in one of our working method; Also, thank him for the [WebConvertor](https://dislink.github.io/midi2bdx/) which brought us so much pressure and power to develop as well as update our projects better, instead of loaf on our project. We hope he can get into a good university as he wantted to!
+-   Thank *Touch “偷吃”*\<QQ1793537164\> for support of debugging and testing program and algorithm, as well his/her suggestions to the improvement of our project
+-   Thank *Mono*\<QQ738893087\> for reporting problems while installing
+-	Thank *Ammelia “艾米利亚”*\<QQ2838334637\> for urging us to develop new functions, and put forward a lot of excellent suggestions for new functions, as well as the BDX file's importing test support provided, which has given a lot of practical theoretical support for our new Structure Generating Algorithm
+-	感谢 *[神羽](https://gitee.com/snowykami) “[SnowyKami](https://github.com/snowyfirefly)”* for supporting and promoting our project
+
+> Thanks for a lot of groupmates's support and help
+>
+> If you have given contribution but haven't been in the list, please contact us!
+
+## Contact Us📞
+
+Meet problems? Welcome to give out your issue [here](https://gitee.com/EillesWan/Musicreater/issues/new)!
+
+Want to get in contact of developers? Welcome to join our [Chat QQ group](https://jq.qq.com/?_wv=1027&k=hpeRxrYr).
+
+
+--------------------------------------------
+
+NOT AN OFFICIAL MINECRAFT PRODUCT.
+
+NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.
+
+此项目并非一个官方 《我的世界》（*Minecraft*）项目
+
+此项目不隶属或关联于 Mojang Studios 或 微软
+
+
+
+
+[Bilibili: Eilles]: https://img.shields.io/badge/Bilibili-%E5%87%8C%E4%BA%91%E9%87%91%E7%BE%BF-00A1E7?style=for-the-badge
+[Bilibili: bgArray]: https://img.shields.io/badge/Bilibili-%E8%AF%B8%E8%91%9B%E4%BA%AE%E4%B8%8E%E5%85%AB%E5%8D%A6%E9%98%B5-00A1E7?style=for-the-badge
+[CodeStyle: black]: https://img.shields.io/badge/code%20style-black-121110.svg?style=for-the-badge
+[python]: https://img.shields.io/badge/python-3.6-AB70FF?style=for-the-badge
+[release]: https://img.shields.io/github/v/release/EillesWan/Musicreater?style=for-the-badge
+[license]: https://img.shields.io/badge/Licence-Apache-228B22?style=for-the-badge

README_en.md

@@ -1,104 +0,0 @@
-# Musicreater
-
-### Introduction
-Musicreater(音·创) is an Eilles(*W-YI*)'s app that is used for creating musics in **Minecraft: Bedrock Edition**.
-
-Welcome to join our QQ group: 861684859
-
-###Author
-
-Eilles (金羿)：The main author, who developed the most and especially the principal parts of Musicreater, and its predecessors, which has been called as "*Minecraft Function Music Maker*", "*Note Fun Creater*", "*Note World Creater*"(now ,they are united as ***Musicreater***!)
-
-bgArray "诸葛亮与八卦阵": Fix bugs, improve code aesthetics, add new functions, change data format, etc.
-
-### Framework
-
-Using *Python* to develop, using Tkinter as a graphics library.
-
-Support Windows7+ && Linux (that supports Python3.8)
-
-***ATTENTION TO DEVELOPERS!!! TO SUPPORT DIFFERENT LANGUAGES, PLEASE USE CONSTANT `READABLETEXT` TO OUTPUT!!! IF YOU NEED TO SUPPLEMENT, PLEASE ADD THEM IN SIMPLEFIED CHINESE\'S LANGUAGE FILE(zhCN.py), WHEATHER WHAT LANGUAGE YOU USE!!!***
-
-
-### Installation
-
-Comming soon...
-
-### Run with Source Code
-
-#### Windows
-
-0.  First, download the source code pack of Musicreater.
-    [Download from Gitee (Need to Login)](https://gitee.com/EillesWan/Musicreater/repository/archive/master.zip)
-    [Download from Github](https://github.com/EillesWan/Musicreater/archive/refs/heads/master.zip)
-1.  Install Python 3.8.10 
-    [Download the 64-bit Python Installer](https://www.python.org/ftp/python/3.8.10/python-3.8.10-amd64.exe)
-    [Download the 32-bit Python Installer](https://www.python.org/ftp/python/3.8.10/python-3.8.10.exe)
-2.  After completing installation, we need to install the libraries :
-    -   Open "Start Menu" and find `cmd`
-    -   Run `cmd` as Administrator
-    -   Drag "补全库.py" into the opened window and press Enter
-3.  After completing installation，double click Musicreater.py to run
-
-#### Linux
-
-0.  If you 're not sure whether your environment is good enough, please run these commands on Terminal
-```bash
-sudo apt-get update
-sudo apt-get upgrade
-sudo apt-get install python3
-sudo apt-get install python3-pip
-sudo apt-get install git
-```
-1.  Now if you are confident enough about your runtime environment, open Terminal on the place which you want to download Musicreater, and run these
-```bash
-sudo git clone https://gitee.com/EillesWan/Musicreater.git
-cd Musicreater
-python3 补全库.py
-python3 Musicreater.py
-```
-
-
-### Instructions
-
-1.  Just make u understand the Chinese
-2.  If u dont understand, u can come to the QQ group or email me to ask questions
-3.  The English Edition is comming soon.
-
-
-### Explanation of bgArray 诸葛亮与八卦阵 (unnecessary)
-
-1. First! The tips here are for those who want to use the multi tone resource package, [Shenyu resource package (Shenyu's own link)](https://pan.baidu.com/s/11uoq5zwN7c3rX-98DqVpJg) \(Extraction code: `ek3t`\)
-2. Download it to any location on your PC. Note that it does ***not*** need to be placed in the directory where *Musicreater* are. The audio resource package is large, so you can choose to download only:`神羽资源包_乐器、音源的资源包\羽音缭绕-midiout_25.0`.
-    Also, you can download only `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\mcpack(国际版推荐)格式_25.0` or 
-    `神羽资源包_乐器\音源的资源包\羽音缭绕-midiout_25.0\zip格式_25.0`.
-4. The next step is the most IMPORTANT: to bind the resource package to *Musicreater*
-    First, open *Musicreater*->Q&A->Select \[MiraclePlumeResourcePack\]... .At this time, in the selection box,
-    the IMPORTANT step comes, select: ***The directory you downloaded: `羽音缭绕-midiout_25.0`, or also the parent directory `mcpack(国际版推荐)格式_25.0`or`zip格式_25.0`***
-    For example, my file path is as follows:
-    `L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0` and in the directory, there are two folders and one .xls file:
-    `神羽资源包_25.0_使用方法.xls`, `mcpack(国际版推荐)格式_25.0` and `zip格式_25.0`, so in *Musicreater* you should also select this folder: **L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0**
-6. If you want to use the Miracle Plume Bedrock Edition Audio Resource Pack to make .mcfunction s, you should use Musicreater -> Edit - > Import audio tracks from MIDI and parse them with a new method, and then use it
-Musicreater - > function (package) - > the following four new functions
-
-### Thanks
-
-1.  Thank [Fuckcraft](https://github.com/fuckcraft) (“鸣凤鸽子” ,etc) for the function of Creating the Websocket Server for Minecraft: Bedrock Edition.
-    -   *!! They have given me the rights to directly copy the lib into Musicreater*
-2.  Thank 昀梦\<QQ1515399885\> for finding and correcting the bugs in the commands that *Musicreater* Created.
-3.  Thank Charlie_Ping “查理平” for bdx convert funtion.
-4.  Thank CMA_2401PT for BDXWorkShop as the .bdx structure's operation guide.
-5.  Thank Miracle Plume “神羽” \<QQshenyu40403\> for the Miracle Plume Bedrock Edition Audio Resource Pack
-6.  Thanks for a lot of groupmates who support me and help me to test the program.
-7.  If you have give me some help but u haven't been in the list, please contact me.
-
-
-### Contact *Eilles(W-YI)*(金羿)
-
-1.  QQ       2647547478
-2.  E-mail   EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
-3.  WeChat   WYI_DoctorYI
-
-### Contact *bgArray*(诸葛亮与八卦阵)
-
-1.  QQ       4740437765

bgArrayLib/bpm.py

@@ -1,57 +0,0 @@
-import mido
-import numpy
-
-
-def mt2gt(mt, tpb_a, bpm_a):
-    return round(mt / tpb_a / bpm_a * 60)
-
-
-def get(mid:mido.MidiFile):
-    # mid = mido.MidiFile(mf)
-    long = mid.length
-    tpb = mid.ticks_per_beat
-    bpm = 20
-    gotV = 0
-
-    for track in mid.tracks:
-        global_time = 0
-        for msg in track:
-            global_time += msg.time
-            if msg.type == "note_on" and msg.velocity > 0:
-                gotV = mt2gt(global_time, tpb, bpm)
-    errorV = numpy.fabs(gotV - long)
-    last_dic = {bpm: errorV}
-    if last_dic.get(bpm) > errorV:
-        last_dic = {bpm: errorV}
-    bpm += 2
-
-    while True:
-        for track in mid.tracks:
-            global_time = 0
-            for msg in track:
-                global_time += msg.time
-                if msg.type == "note_on" and msg.velocity > 0:
-                    gotV = mt2gt(global_time, tpb, bpm)
-        errorV = numpy.fabs(gotV - long)
-        try:
-            if last_dic.get(bpm - 2) > errorV:
-                last_dic = {bpm: errorV}
-        except TypeError:
-            pass
-        bpm += 2
-        if bpm >= 252:
-            break
-    print(list(last_dic.keys())[0])
-    return list(last_dic.keys())[0]
-
-
-def compute(mid:mido.MidiFile):
-    answer = 60000000/mid.ticks_per_beat
-    print(answer)
-    return answer
-
-
-if __name__ == '__main__':
-    mid = mido.MidiFile(r"C:\Users\lc\Documents\MuseScore3\乐谱\乐谱\Bad style - Time back.mid")
-    get(mid)
-    compute(mid)

bgArrayLib/compute.py

@@ -1,40 +0,0 @@
-def round_up(num, power=0):
-    """
-    实现精确四舍五入，包含正、负小数多种场景
-    :param num: 需要四舍五入的小数
-    :param power: 四舍五入位数，支持0-∞
-    :return: 返回四舍五入后的结果
-    """
-    try:
-        print(1 / 0)
-    except ZeroDivisionError:
-        digit = 10 ** power
-        num2 = float(int(num * digit))
-        # 处理正数，power不为0的情况
-        if num >= 0 and power != 0:
-            tag = num * digit - num2 + 1 / (digit * 10)
-            if tag >= 0.5:
-                return (num2 + 1) / digit
-            else:
-                return num2 / digit
-        # 处理正数，power为0取整的情况
-        elif num >= 0 and power == 0:
-            tag = num * digit - int(num)
-            if tag >= 0.5:
-                return (num2 + 1) / digit
-            else:
-                return num2 / digit
-        # 处理负数，power为0取整的情况
-        elif power == 0 and num < 0:
-            tag = num * digit - int(num)
-            if tag <= -0.5:
-                return (num2 - 1) / digit
-            else:
-                return num2 / digit
-        # 处理负数，power不为0的情况
-        else:
-            tag = num * digit - num2 - 1 / (digit * 10)
-            if tag <= -0.5:
-                return (num2 - 1) / digit
-            else:
-                return num2 / digit

bgArrayLib/namesConstant.py

@@ -1,92 +0,0 @@
-zip_name = {-1: '-1.Acoustic_Kit_打击乐.zip', 0: '0.Acoustic_Grand_Piano_大钢琴.zip', 1: '1.Bright_Acoustic_Piano_亮音大钢琴.zip',
-            10: '10.Music_Box_八音盒.zip', 100: '100.FX_brightness_合成特效-亮音.zip', 101: '101.FX_goblins_合成特效-小妖.zip',
-            102: '102.FX_echoes_合成特效-回声.zip', 103: '103.FX_sci-fi_合成特效-科幻.zip', 104: '104.Sitar_锡塔尔.zip',
-            105: '105.Banjo_班卓.zip', 106: '106.Shamisen_三味线.zip', 107: '107.Koto_筝.zip', 108: '108.Kalimba_卡林巴.zip',
-            109: '109.Bagpipe_风笛.zip', 11: '11.Vibraphone_电颤琴.zip', 110: '110.Fiddle_古提琴.zip', 111: '111.Shanai_唢呐.zip',
-            112: '112.Tinkle_Bell_铃铛.zip', 113: '113.Agogo_拉丁打铃.zip', 114: '114.Steel_Drums_钢鼓.zip',
-            115: '115.Woodblock_木块.zip', 116: '116.Taiko_Drum_太鼓.zip', 117: '117.Melodic_Tom_嗵鼓.zip',
-            118: '118.Synth_Drum_合成鼓.zip', 119: '119.Reverse_Cymbal_镲波形反转.zip', 12: '12.Marimba_马林巴.zip',
-            13: '13.Xylophone_木琴.zip', 14: '14.Tubular_Bells_管钟.zip', 15: '15.Dulcimer_扬琴.zip',
-            16: '16.Drawbar_Organ_击杆风琴.zip', 17: '17.Percussive_Organ_打击型风琴.zip', 18: '18.Rock_Organ_摇滚风琴.zip',
-            19: '19.Church_Organ_管风琴.zip', 2: '2.Electric_Grand_Piano_电子大钢琴.zip', 20: '20.Reed_Organ_簧风琴.zip',
-            21: '21.Accordion_手风琴.zip', 22: '22.Harmonica_口琴.zip', 23: '23.Tango_Accordian_探戈手风琴.zip',
-            24: '24.Acoustic_Guitar_(nylon)_尼龙弦吉他.zip', 25: '25.Acoustic_Guitar(steel)_钢弦吉他.zip',
-            26: '26.Electric_Guitar_(jazz)_爵士乐电吉他.zip', 27: '27.Electric_Guitar_(clean)_清音电吉他.zip',
-            28: '28.Electric_Guitar_(muted)_弱音电吉他.zip', 29: '29.Overdriven_Guitar_驱动音效吉他.zip',
-            3: '3.Honky-Tonk_Piano_酒吧钢琴.zip', 30: '30.Distortion_Guitar_失真音效吉他.zip', 31: '31.Guitar_Harmonics_吉他泛音.zip',
-            32: '32.Acoustic_Bass_原声贝司.zip', 33: '33.Electric_Bass(finger)_指拨电贝司.zip',
-            34: '34.Electric_Bass(pick)_拨片拨电贝司.zip', 35: '35.Fretless_Bass_无品贝司.zip', 36: '36.Slap_Bass_A_击弦贝司A.zip',
-            37: '37.Slap_Bass_B_击弦贝司B.zip', 38: '38.Synth_Bass_A_合成贝司A.zip', 39: '39.Synth_Bass_B_合成贝司B.zip',
-            4: '4.Electric_Piano_1_电钢琴A.zip', 40: '40.Violin_小提琴.zip', 41: '41.Viola_中提琴.zip', 42: '42.Cello_大提琴.zip',
-            43: '43.Contrabass_低音提琴.zip', 44: '44.Tremolo_Strings_弦乐震音.zip', 45: '45.Pizzicato_Strings_弦乐拨奏.zip',
-            46: '46.Orchestral_Harp_竖琴.zip', 47: '47.Timpani_定音鼓.zip', 48: '48.String_Ensemble_A_弦乐合奏A.zip',
-            49: '49.String_Ensemble_B_弦乐合奏B.zip', 5: '5.Electric_Piano_2_电钢琴B.zip', 50: '50.SynthStrings_A_合成弦乐A.zip',
-            51: '51.SynthStrings_B_合成弦乐B.zip', 52: '52.Choir_Aahs_合唱“啊”音.zip', 53: '53.Voice_Oohs_人声“哦”音.zip',
-            54: '54.Synth_Voice_合成人声.zip', 55: '55.Orchestra_Hit_乐队打击乐.zip', 56: '56.Trumpet_小号.zip',
-            57: '57.Trombone_长号.zip', 58: '58.Tuba_大号.zip', 59: '59.Muted_Trumpet_弱音小号.zip',
-            6: '6.Harpsichord_拨弦古钢琴.zip', 60: '60.French_Horn_圆号.zip', 61: '61.Brass_Section_铜管组.zip',
-            62: '62.Synth_Brass_A_合成铜管A.zip', 63: '63.Synth_Brass_A_合成铜管B.zip', 64: '64.Soprano_Sax_高音萨克斯.zip',
-            65: '65.Alto_Sax_中音萨克斯.zip', 66: '66.Tenor_Sax_次中音萨克斯.zip', 67: '67.Baritone_Sax_上低音萨克斯.zip',
-            68: '68.Oboe_双簧管.zip', 69: '69.English_Horn_英国管.zip', 7: '7.Clavinet_击弦古钢琴.zip', 70: '70.Bassoon_大管.zip',
-            71: '71.Clarinet_单簧管.zip', 72: '72.Piccolo_短笛.zip', 73: '73.Flute_长笛.zip', 74: '74.Recorder_竖笛.zip',
-            75: '75.Pan_Flute_排笛.zip', 76: '76.Bottle_Blow_吹瓶口.zip', 77: '77.Skakuhachi_尺八.zip', 78: '78.Whistle_哨.zip',
-            79: '79.Ocarina_洋埙.zip', 8: '8.Celesta_钢片琴.zip', 80: '80.Lead_square_合成主音-方波.zip',
-            81: '81.Lead_sawtooth_合成主音-锯齿波.zip', 82: '82.Lead_calliope_lead_合成主音-汽笛风琴.zip',
-            83: '83.Lead_chiff_lead_合成主音-吹管.zip', 84: '84.Lead_charang_合成主音5-吉他.zip', 85: '85.Lead_voice_合成主音-人声.zip',
-            86: '86.Lead_fifths_合成主音-五度.zip', 87: '87.Lead_bass+lead_合成主音-低音加主音.zip', 88: '88.Pad_new_age_合成柔音-新时代.zip',
-            89: '89.Pad_warm_合成柔音-暖音.zip', 9: '9.Glockenspiel_钟琴.zip', 90: '90.Pad_polysynth_合成柔音-复合成.zip',
-            91: '91.Pad_choir_合成柔音-合唱.zip', 92: '92.Pad_bowed_合成柔音-弓弦.zip', 93: '93.Pad_metallic_合成柔音-金属.zip',
-            94: '94.Pad_halo_合成柔音-光环.zip', 95: '95.Pad_sweep_合成柔音-扫弦.zip', 96: '96.FX_rain_合成特效-雨.zip',
-            97: '97.FX_soundtrack_合成特效-音轨.zip', 98: '98.FX_crystal_合成特效-水晶.zip', 99: '99.FX_atmosphere_合成特效-大气.zip'}
-
-mcpack_name = {-1: '-1.Acoustic_Kit_打击乐.mcpack', 0: '0.Acoustic_Grand_Piano_大钢琴.mcpack',
-               1: '1.Bright_Acoustic_Piano_亮音大钢琴.mcpack', 10: '10.Music_Box_八音盒.mcpack',
-               100: '100.FX_brightness_合成特效-亮音.mcpack', 101: '101.FX_goblins_合成特效-小妖.mcpack',
-               102: '102.FX_echoes_合成特效-回声.mcpack', 103: '103.FX_sci-fi_合成特效-科幻.mcpack', 104: '104.Sitar_锡塔尔.mcpack',
-               105: '105.Banjo_班卓.mcpack', 106: '106.Shamisen_三味线.mcpack', 107: '107.Koto_筝.mcpack',
-               108: '108.Kalimba_卡林巴.mcpack', 109: '109.Bagpipe_风笛.mcpack', 11: '11.Vibraphone_电颤琴.mcpack',
-               110: '110.Fiddle_古提琴.mcpack', 111: '111.Shanai_唢呐.mcpack', 112: '112.Tinkle_Bell_铃铛.mcpack',
-               113: '113.Agogo_拉丁打铃.mcpack', 114: '114.Steel_Drums_钢鼓.mcpack', 115: '115.Woodblock_木块.mcpack',
-               116: '116.Taiko_Drum_太鼓.mcpack', 117: '117.Melodic_Tom_嗵鼓.mcpack', 118: '118.Synth_Drum_合成鼓.mcpack',
-               119: '119.Reverse_Cymbal_镲波形反转.mcpack', 12: '12.Marimba_马林巴.mcpack', 13: '13.Xylophone_木琴.mcpack',
-               14: '14.Tubular_Bells_管钟.mcpack', 15: '15.Dulcimer_扬琴.mcpack', 16: '16.Drawbar_Organ_击杆风琴.mcpack',
-               17: '17.Percussive_Organ_打击型风琴.mcpack', 18: '18.Rock_Organ_摇滚风琴.mcpack',
-               19: '19.Church_Organ_管风琴.mcpack', 2: '2.Electric_Grand_Piano_电子大钢琴.mcpack',
-               20: '20.Reed_Organ_簧风琴.mcpack', 21: '21.Accordion_手风琴.mcpack', 22: '22.Harmonica_口琴.mcpack',
-               23: '23.Tango_Accordian_探戈手风琴.mcpack', 24: '24.Acoustic_Guitar_(nylon)_尼龙弦吉他.mcpack',
-               25: '25.Acoustic_Guitar(steel)_钢弦吉他.mcpack', 26: '26.Electric_Guitar_(jazz)_爵士乐电吉他.mcpack',
-               27: '27.Electric_Guitar_(clean)_清音电吉他.mcpack', 28: '28.Electric_Guitar_(muted)_弱音电吉他.mcpack',
-               29: '29.Overdriven_Guitar_驱动音效吉他.mcpack', 3: '3.Honky-Tonk_Piano_酒吧钢琴.mcpack',
-               30: '30.Distortion_Guitar_失真音效吉他.mcpack', 31: '31.Guitar_Harmonics_吉他泛音.mcpack',
-               32: '32.Acoustic_Bass_原声贝司.mcpack', 33: '33.Electric_Bass(finger)_指拨电贝司.mcpack',
-               34: '34.Electric_Bass(pick)_拨片拨电贝司.mcpack', 35: '35.Fretless_Bass_无品贝司.mcpack',
-               36: '36.Slap_Bass_A_击弦贝司A.mcpack', 37: '37.Slap_Bass_B_击弦贝司B.mcpack', 38: '38.Synth_Bass_A_合成贝司A.mcpack',
-               39: '39.Synth_Bass_B_合成贝司B.mcpack', 4: '4.Electric_Piano_1_电钢琴A.mcpack', 40: '40.Violin_小提琴.mcpack',
-               41: '41.Viola_中提琴.mcpack', 42: '42.Cello_大提琴.mcpack', 43: '43.Contrabass_低音提琴.mcpack',
-               44: '44.Tremolo_Strings_弦乐震音.mcpack', 45: '45.Pizzicato_Strings_弦乐拨奏.mcpack',
-               46: '46.Orchestral_Harp_竖琴.mcpack', 47: '47.Timpani_定音鼓.mcpack', 48: '48.String_Ensemble_A_弦乐合奏A.mcpack',
-               49: '49.String_Ensemble_B_弦乐合奏B.mcpack', 5: '5.Electric_Piano_2_电钢琴B.mcpack',
-               50: '50.SynthStrings_A_合成弦乐A.mcpack', 51: '51.SynthStrings_B_合成弦乐B.mcpack',
-               52: '52.Choir_Aahs_合唱“啊”音.mcpack', 53: '53.Voice_Oohs_人声“哦”音.mcpack', 54: '54.Synth_Voice_合成人声.mcpack',
-               55: '55.Orchestra_Hit_乐队打击乐.mcpack', 56: '56.Trumpet_小号.mcpack', 57: '57.Trombone_长号.mcpack',
-               58: '58.Tuba_大号.mcpack', 59: '59.Muted_Trumpet_弱音小号.mcpack', 6: '6.Harpsichord_拨弦古钢琴.mcpack',
-               60: '60.French_Horn_圆号.mcpack', 61: '61.Brass_Section_铜管组.mcpack', 62: '62.Synth_Brass_A_合成铜管A.mcpack',
-               63: '63.Synth_Brass_A_合成铜管B.mcpack', 64: '64.Soprano_Sax_高音萨克斯.mcpack', 65: '65.Alto_Sax_中音萨克斯.mcpack',
-               66: '66.Tenor_Sax_次中音萨克斯.mcpack', 67: '67.Baritone_Sax_上低音萨克斯.mcpack', 68: '68.Oboe_双簧管.mcpack',
-               69: '69.English_Horn_英国管.mcpack', 7: '7.Clavinet_击弦古钢琴.mcpack', 70: '70.Bassoon_大管.mcpack',
-               71: '71.Clarinet_单簧管.mcpack', 72: '72.Piccolo_短笛.mcpack', 73: '73.Flute_长笛.mcpack',
-               74: '74.Recorder_竖笛.mcpack', 75: '75.Pan_Flute_排笛.mcpack', 76: '76.Bottle_Blow_吹瓶口.mcpack',
-               77: '77.Skakuhachi_尺八.mcpack', 78: '78.Whistle_哨.mcpack', 79: '79.Ocarina_洋埙.mcpack',
-               8: '8.Celesta_钢片琴.mcpack', 80: '80.Lead_square_合成主音-方波.mcpack', 81: '81.Lead_sawtooth_合成主音-锯齿波.mcpack',
-               82: '82.Lead_calliope_lead_合成主音-汽笛风琴.mcpack', 83: '83.Lead_chiff_lead_合成主音-吹管.mcpack',
-               84: '84.Lead_charang_合成主音5-吉他.mcpack', 85: '85.Lead_voice_合成主音-人声.mcpack',
-               86: '86.Lead_fifths_合成主音-五度.mcpack', 87: '87.Lead_bass+lead_合成主音-低音加主音.mcpack',
-               88: '88.Pad_new_age_合成柔音-新时代.mcpack', 89: '89.Pad_warm_合成柔音-暖音.mcpack', 9: '9.Glockenspiel_钟琴.mcpack',
-               90: '90.Pad_polysynth_合成柔音-复合成.mcpack', 91: '91.Pad_choir_合成柔音-合唱.mcpack',
-               92: '92.Pad_bowed_合成柔音-弓弦.mcpack', 93: '93.Pad_metallic_合成柔音-金属.mcpack',
-               94: '94.Pad_halo_合成柔音-光环.mcpack', 95: '95.Pad_sweep_合成柔音-扫弦.mcpack', 96: '96.FX_rain_合成特效-雨.mcpack',
-               97: '97.FX_soundtrack_合成特效-音轨.mcpack', 98: '98.FX_crystal_合成特效-水晶.mcpack',
-               99: '99.FX_atmosphere_合成特效-大气.mcpack'}
-
-if __name__ == '__main__':
-    print(zip_name[0])

bgArrayLib/pitchStrConstant.py

@@ -1,133 +0,0 @@
-pitch = {
-            '0': '0.0220970869120796',
-            '1': '0.0234110480761981',
-            '2': '0.0248031414370031',
-            '3': '0.0262780129766786',
-            '4': '0.0278405849418856',
-            '5': '0.0294960722713029',
-            '6': '0.03125',
-            '7': '0.033108221698728',
-            '8': '0.0350769390096679',
-            '9': '0.037162722343835',
-            '10': '0.0393725328092148',
-            '11': '0.0417137454428136',
-            '12': '0.0441941738241592',
-            '13': '0.0468220961523963',
-            '14': '0.0496062828740062',
-            '15': '0.0525560259533572',
-            '16': '0.0556811698837712',
-            '17': '0.0589921445426059',
-            '18': '0.0625',
-            '19': '0.066216443397456',
-            '20': '0.0701538780193358',
-            '21': '0.0743254446876701',
-            '22': '0.0787450656184296',
-            '23': '0.0834274908856271',
-            '24': '0.0883883476483184',
-            '25': '0.0936441923047926',
-            '26': '0.0992125657480125',
-            '27': '0.105112051906714',
-            '28': '0.111362339767542',
-            '29': '0.117984289085212',
-            '30': '0.125',
-            '31': '0.132432886794912',
-            '32': '0.140307756038672',
-            '33': '0.14865088937534',
-            '34': '0.157490131236859',
-            '35': '0.166854981771254',
-            '36': '0.176776695296637',
-            '37': '0.187288384609585',
-            '38': '0.198425131496025',
-            '39': '0.210224103813429',
-            '40': '0.222724679535085',
-            '41': '0.235968578170423',
-            '42': '0.25',
-            '43': '0.264865773589824',
-            '44': '0.280615512077343',
-            '45': '0.29730177875068',
-            '46': '0.314980262473718',
-            '47': '0.333709963542509',
-            '48': '0.353553390593274',
-            '49': '0.37457676921917',
-            '50': '0.39685026299205',
-            '51': '0.420448207626857',
-            '52': '0.44544935907017',
-            '53': '0.471937156340847',
-            '54': '0.5',
-            '55': '0.529731547179648',
-            '56': '0.561231024154687',
-            '57': '0.594603557501361',
-            '58': '0.629960524947437',
-            '59': '0.667419927085017',
-            '60': '0.707106781186548',
-            '61': '0.749153538438341',
-            '62': '0.7937005259841',
-            '63': '0.840896415253715',
-            '64': '0.890898718140339',
-            '65': '0.943874312681694',
-            '66': '1',
-            '67': '1.0594630943593',
-            '68': '1.12246204830937',
-            '69': '1.18920711500272',
-            '70': '1.25992104989487',
-            '71': '1.33483985417003',
-            '72': '1.4142135623731',
-            '73': '1.49830707687668',
-            '74': '1.5874010519682',
-            '75': '1.68179283050743',
-            '76': '1.78179743628068',
-            '77': '1.88774862536339',
-            '78': '2',
-            '79': '2.11892618871859',
-            '80': '2.24492409661875',
-            '81': '2.37841423000544',
-            '82': '2.51984209978975',
-            '83': '2.66967970834007',
-            '84': '2.82842712474619',
-            '85': '2.99661415375336',
-            '86': '3.1748021039364',
-            '87': '3.36358566101486',
-            '88': '3.56359487256136',
-            '89': '3.77549725072677',
-            '90': '4',
-            '91': '4.23785237743718',
-            '92': '4.48984819323749',
-            '93': '4.75682846001088',
-            '94': '5.03968419957949',
-            '95': '5.33935941668014',
-            '96': '5.65685424949238',
-            '97': '5.99322830750673',
-            '98': '6.3496042078728',
-            '99': '6.72717132202972',
-            '100': '7.12718974512272',
-            '101': '7.55099450145355',
-            '102': '8',
-            '103': '8.47570475487436',
-            '104': '8.97969638647498',
-            '105': '9.51365692002177',
-            '106': '10.079368399159',
-            '107': '10.6787188333603',
-            '108': '11.3137084989848',
-            '109': '11.9864566150135',
-            '110': '12.6992084157456',
-            '111': '13.4543426440594',
-            '112': '14.2543794902454',
-            '113': '15.1019890029071',
-            '114': '16',
-            '115': '16.9514095097487',
-            '116': '17.95939277295',
-            '117': '19.0273138400435',
-            '118': '20.158736798318',
-            '119': '21.3574376667206',
-            '120': '22.6274169979695',
-            '121': '23.9729132300269',
-            '122': '25.3984168314912',
-            '123': '26.9086852881189',
-            '124': '28.5087589804909',
-            '125': '30.2039780058142',
-            '126': '32',
-            '127': '33.9028190194974',
-            '128': '35.9187855458999',
-            '129': '38.0546276800871',
-            '130': '40.3174735966359',
-            '131': '42.7148753334411'}

bgArrayLib/reader.py

@@ -1,148 +0,0 @@
-# -*- coding: utf-8 -*-
-
-
-from nmcsup.log import log
-import pickle
-
-
-class Note:
-    def __init__(self, channel, pitch, velocity, time, time_position, instrument):
-        self.channel = channel
-        self.pitch = pitch
-        self.velocity = velocity
-        self.delay = time
-        self.time_position = time_position
-        self.instrument = instrument
-        self.CD = "d"
-
-    def get_CD(self, start, end):
-        if end - start > 1.00:
-            self.CD = "c"
-        else:
-            self.CD = "d"
-
-
-def midiNewReader(midfile: str):
-    import mido
-    # from msctspt.threadOpera import NewThread
-    from bgArrayLib.bpm import get
-
-    def Time(mt, tpb_a, bpm_a):
-        return round(mt / tpb_a / bpm_a * 60 * 20)
-
-    Notes = []
-    tracks = []
-    note_list = []
-    close = []
-    on = []
-    off = []
-    instruments = []
-    isPercussion = False
-    try:
-        mid = mido.MidiFile(midfile)
-    except Exception:
-        log("找不到文件或无法读取文件" + midfile)
-        return False
-    tpb = mid.ticks_per_beat
-    bpm = get(mid)
-    # 解析
-    # def loadMidi(track1):
-    for track in mid.tracks:
-        overallTime = 0.0
-        instrument = 0
-        for i in track:
-            overallTime += i.time
-            try:
-                if i.channel != 9:
-                    # try:
-                    #     log("event_type(事件): " + str(i.type) + " channel(音轨): " + str(i.channel) +
-                    #     " note/pitch(音高): " +
-                    #         str(i[2]) +
-                    #         " velocity(力度): " + str(i.velocity) + " time(间隔时间): " + str(i.time) +
-                    #         " overallTime/globalTime/timePosition: " + str(overallTime) + " \n")
-                    # except AttributeError:
-                    #     log("event_type(事件): " + str(i.type) + " thing(内容)：" + str(i) + " \n")
-                    if 'program_change' in str(i):
-                        instrument = i.program
-                        if instrument > 119:  # 音色不够
-                            pass
-                        else:
-                            instruments.append(i.program)
-                    if 'note_on' in str(i) and i.velocity > 0:
-                        print(i)
-                        # print(i.note)
-                        # print([Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), instrument)])
-                        tracks.append(
-                            [Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), instrument)])
-                        note_list.append(
-                            [i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), instrument])
-                        on.append([i.note, Time(overallTime, tpb, bpm)])
-                        # return [Note(i.channel, i, i.velocity, i.time, Time(overallTime, tpb, bpm))]
-                    if 'note_off' in str(i) or 'note_on' in str(i) and i.velocity == 0:
-                        # print(i)
-                        # print([Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm))])
-                        close.append(
-                            [Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), instrument)])
-                        off.append([i.note, Time(overallTime, tpb, bpm)])
-                        # return [Note(i.channel, i, i.velocity, i.time, Time(overallTime, tpb, bpm))]
-            except AttributeError:
-                pass
-            if 'note_on' in str(i) and i.channel == 9:
-                if 'note_on' in str(i) and i.velocity > 0:
-                    print(i)
-                    # print(i.note)
-                    # print([Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), -1)])
-                    tracks.append([Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), -1)])
-                    note_list.append([i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), -1])
-                    on.append([i.note, Time(overallTime, tpb, bpm)])
-                    isPercussion = True
-                    # return [Note(i.channel, i, i.velocity, i.time, Time(overallTime, tpb, bpm))]
-        Notes.append(tracks)
-    if instruments is []:
-        instruments.append(0)
-    instruments = list(set(instruments))
-    with open("1.pkl", 'wb') as b:
-        pickle.dump([instruments, isPercussion], b)
-
-    # for j, track in enumerate(mid.tracks):
-    #     th = NewThread(loadMidi, (track,))
-    #     th.start()
-    #     Notes.append(th.getResult())
-
-    # print(Notes)
-    print(Notes.__len__())
-    # print(note_list)
-    print(instruments)
-    return Notes
-    # return [Notes, note_list]
-
-
-def midiClassReader(midfile: str):
-    import mido
-    from bgArrayLib.bpm import get
-
-    def Time(mt, tpb_a, bpm_a):
-        return round(mt / tpb_a / bpm_a * 60 * 20)
-
-    Notes = []
-    tracks = []
-    try:
-        mid = mido.MidiFile(filename=midfile,clip=True)
-    except Exception:
-        log("找不到文件或无法读取文件" + midfile)
-        return False
-    log("midi已经载入了。")
-    tpb = mid.ticks_per_beat
-    bpm = get(mid)
-    for track in mid.tracks:
-        overallTime = 0.0
-        instrument = 0
-        for i in track:
-            overallTime += i.time
-            if 'note_on' in str(i) and i.velocity > 0:
-                print(i)
-                tracks.append(
-                    [Note(i.channel, i.note, i.velocity, i.time, Time(overallTime, tpb, bpm), instrument)])
-        Notes.append(tracks)
-    print(Notes.__len__())
-    return Notes

bgArrayLib/sy_resourcesPacker.py

@@ -1,131 +0,0 @@
-import os
-import pickle
-# import tkinter.filedialog
-# from namesConstant import zip_name
-# from namesConstant import mcpack_name
-import bgArrayLib.namesConstant
-import shutil
-zipN = bgArrayLib.namesConstant.zip_name
-mpN = bgArrayLib.namesConstant.mcpack_name
-
-manifest = {
-  "format_version": 1,
-  "header": {
-    "name": "羽音缭绕-midiout_25.5--音创使用",
-    "description": "羽音缭绕-midiout_25.0--音创使用",
-    "uuid": "c1adbda4-3b3e-4e5b-a57e-cde8ac80ee19",
-    "version": [25, 5, 0]
-  },
-  "modules": [
-    {
-      "description": "羽音缭绕-midiout_25.0--音创使用",
-      "type": "resources",
-      "uuid": "c13455d5-b9f3-47f2-9706-c05ad86b3180 ",
-      "version": [25, 5, 0]
-    }
-  ]
-}
-
-
-def resources_pathSetting(newPath: str = ""):
-    if not os.path.isfile("./bgArrayLib/resourcesPath.rpposi") and newPath == "":
-        return [False, 1]  # 1:没有路径文件
-    elif newPath != "":  # not os.path.isfile("./bgArrayLib/resourcesPath.rpposi") and
-        path = newPath
-        print(path)
-        with open("./bgArrayLib/resourcesPath.rpposi", 'w') as w:
-            w.write(path)
-        if "mcpack(国际版推荐)格式_25.0" in os.listdir(path) and "zip格式_25.0" in os.listdir(path):
-            return [True, path, 1]  # 1:都有
-        elif "mcpack(国际版推荐)格式_25.0" in os.listdir(path) and "zip格式_25.0" not in os.listdir(path):
-            return [True, path, 2]  # 2:有pack
-        elif "mcpack(国际版推荐)格式_25.0" not in os.listdir(path) and "zip格式_25.0" in os.listdir(path):
-            return [True, path, 3]  # 3:有zip
-        else:
-            return [False, 2]  # 2:路径文件指示错误
-    if os.path.isfile("./bgArrayLib/resourcesPath.rpposi") and newPath == "":
-        with open("./bgArrayLib/resourcesPath.rpposi", 'r') as f:
-            path = f.read()
-        if "mcpack(国际版推荐)格式_25.0" in os.listdir(path) and "zip格式_25.0" in os.listdir(path):
-            return [True, path, 1]  # 1:都有
-        elif "mcpack(国际版推荐)格式_25.0" in os.listdir(path) and "zip格式_25.0" not in os.listdir(path):
-            return [True, path, 2]  # 2:有pack
-        elif "mcpack(国际版推荐)格式_25.0" not in os.listdir(path) and "zip格式_25.0" in os.listdir(path):
-            return [True, path, 3]  # 3:有zip
-        else:
-            return [False, 2]  # 2:路径文件指示错误
-
-
-def choose_resources():
-    global zipN
-    global mpN
-    back_list = []
-    try:
-        with open(r"1.pkl", 'rb') as rb:
-            instrument = list(pickle.load(rb))
-        print(instrument)
-    except FileNotFoundError:
-        try:
-            with open(r"./nmcsup/1.pkl", 'rb') as rb:
-                instrument = list(pickle.load(rb))
-            print(instrument)
-        except FileNotFoundError:
-            return False
-    path = resources_pathSetting()
-    if path.__len__() == 2:
-        return path
-    else:
-        dataT = path[2]
-        pathT = path[1]
-    if dataT == 1:
-        if instrument[1] is True:
-            index = zipN.get(-1)
-            percussion_instrument = str(pathT) + "\\zip格式_25.0\\" + index
-            # print(percussion_instrument)
-            back_list.append(percussion_instrument)
-        for i in instrument[0]:
-            ins_p = str(pathT) + "\\zip格式_25.0\\" + str(zipN.get(i))
-            # print(ins_p)
-            back_list.append(ins_p)
-        print(back_list)
-        return back_list
-    elif dataT == 2:
-        if instrument[1] is True:
-            index = mpN.get(-1)
-            percussion_instrument = str(pathT) + "\\mcpack(国际版推荐)格式_25.0\\" + index
-            # print(percussion_instrument)
-            back_list.append(percussion_instrument)
-        for i in instrument[0]:
-            ins_p = str(pathT) + "\\mcpack(国际版推荐)格式_25.0\\" + str(mpN.get(i))
-            # print(ins_p)
-            back_list.append(ins_p)
-        print(back_list)
-        return back_list
-    elif dataT == 3:
-        if instrument[1] is True:
-            index = zipN.get(-1)
-            percussion_instrument = str(pathT) + "\\zip格式_25.0\\" + index
-            # print(percussion_instrument)
-            back_list.append(percussion_instrument)
-        for i in instrument[0]:
-            ins_p = str(pathT) + "\\zip格式_25.0\\" + str(zipN.get(i))
-            # print(ins_p)
-            back_list.append(ins_p)
-        print(back_list)
-        return back_list
-
-
-def scatteredPack(path):
-    pack_list = choose_resources()
-    print(pack_list)
-    print(path)
-    # os.close("L:/0WorldMusicCreater-MFMS new edition")
-    # shutil.copy("L:\\shenyu\\音源的资源包\\羽音缭绕-midiout_25.0\\mcpack(国际版推荐)格式_25.0\\0.Acoustic_Grand_Piano_大钢琴.mcpack",
-    #                 "L:/0WorldMusicCreater-MFMS new edition")
-    for i in pack_list:
-        shutil.copy(i, path)
-
-
-if __name__ == '__main__':
-    # print(resources_pathSetting(r"L:\shenyu\音源的资源包\羽音缭绕-midiout_25.0"))
-    choose_resources()

clean_update.py

@@ -0,0 +1,22 @@
+import shutil
+import os
+from rich.console import Console
+from rich.progress import track
+
+console = Console()
+
+
+def main():
+    with console.status("Find the full path of .egg-info folder"):
+        egg_info: list = []
+        for file in os.listdir():
+            if file.endswith(".egg-info"):
+                egg_info.append(file)
+                console.print(file)
+    for file in track(["build", "dist", "logs", *egg_info], description="Deleting files"):
+        if os.path.isdir(file) and os.access(file, os.W_OK):
+            shutil.rmtree(file)
+
+
+if __name__ == "__main__":
+    main()

docs/库的生成与功能文档.md

@@ -0,0 +1,204 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<h2 align="center">库版 Package Version</h2>
+
+<p align="center">
+<img width="128" height="128" src="https://s1.ax1x.com/2022/05/06/Ouhghj.md.png" >
+</p>
+
+**此为开发相关文档，内容包括：所生成文件结构的详细说明、特殊参数的详细解释**
+
+# 库的简单调用
+
+参见[example.py的相关部分](../example.py#L120)，使用此库进行MIDI转换非常简单。
+
+```python
+import Musicreater	# 导入转换库
+
+old_execute_format = False	# 指定是否使用旧的execute指令语法（即1.18及以前的《我的世界：基岩版》语法）
+
+# 首先新建转换对象。
+conversion = Musicreater.midiConvert(enable_old_exe_format = old_execute_format)
+# 值得注意的是，一个转换对象可以转换多个文件。
+# 也就是在实例化的时候不进行对文件的绑定。
+# 如果有调试需要，可以在实例化时传入参数 debug = True
+# 如：conversion = Musicreater.midiConvert(debug=True)
+
+# 设置输入输出地址，并指定execute指令语法
+# 地址都为字符串类型，不能传入文件流
+midi_path = "./where/you/place/.midi/files.mid"
+output_folder = "./where/you/want2/convert/into/"
+
+# 设定基本转换参数
+conversion.convert(midi_path,output_folder)
+
+# 进行转换并接受输出，具体的参数均在代码之文档中有相关说明
+method_id = 3	# 指定使用的转换算法
+
+# 使用计分板播放器，转换为附加包文件
+convertion_result = conversion.to_mcpack(method_id,*prompts)
+
+# 使用延迟播放器，转换为附加包文件
+# 注意，在执行这个功能之前，你需要使用指令
+# pip install TrimMCStruct
+# 安装最新版的TrimMCStruct库
+convertion_result = conversion.to_mcpack_with_delay(method_id,*prompts)
+
+# 使用计分板播放器，转换为BDX结构文件
+convertion_result = conversion.to_BDX_file(method_id,*prompts)
+
+# 使用延迟播放器，转换为BDX结构文件
+convertion_result = conversion.to_BDX_file_with_delay(method_id,*prompts)
+
+# 转换结果是一个元组。
+# 若其转换成功，则前三位必为
+# True, 指令数量, 最大延迟
+# 其中，最大延迟可以理解为计分板的最大值
+# 如果转换失败，暂时还没有定返回值的规则
+# 但是有一点是肯定的，数据结构必定是元组
+print(convertion_result)
+```
+
+
+#	生成文件结构
+
+##	名词解释
+
+|名词|解释|备注|
+|--------|-----------|----------|
+|指令区|一个用于放置指令系统的区域，通常是常加载区。|常见于服务器指令系统、好友联机房间中|
+|指令链（链）|与链式指令方块不同，一个指令链通常指代的是一串由某种非链式指令方块作为开头，后面连着一串链式指令方块的结构。|通常的链都应用于需要“单次激活而多指令”的简单功能|
+|起始块|链最初的那个非链式指令方块。|此方块为脉冲方块或重复方块皆可|
+|指令系统（系统）|指令系统通常指的是，由一个或多个指令链以及相关红石机构相互配合、一同组成的，为达到某种特定的功能而构建的整体结构。|通常的系统都应用于需要“综合调配指令”的复杂功能。可由多个实现不同功能的模块构成，不同系统之间可以相互调用各自的模块。|
+|游戏刻（刻）|游戏的一刻是指《我的世界》的游戏循环运行一次所占用的时间。（[详见《我的世界》中文维基](https://minecraft.fandom.com/zh/wiki/%E5%88%BB#%E6%B8%B8%E6%88%8F%E5%88%BB)）。指令方块的延迟功能（即指令方块的“延迟刻数”设置项，此项的名称被误译为“已选中项的延迟”）的单位即为`1`游戏刻。|正常情况下，游戏固定以每秒钟20刻的速率运行。但是，由于游戏内的绝大多数操作都是基于刻数而非现实中的时间来计时并进行的，一次游戏循环内也许会发生大量的操作，很多情况下，一秒对应的游戏刻会更少。 |
+
+##	文件格式
+
+1.	附加包格式（`.mcpack`）
+
+	使用附加包格式导出音乐，则音乐会以指令函数文件（`.mcfunction`）存储于附加包内。在附加包中，函数文件的存储结构应为：
+
+	- `functions\`
+		- `index.mcfunction`
+		- `mscply\`
+			- `progressShow.mcfunction`
+			- `track1.mcfunction`
+			- `track2.mcfunction`
+			- ...
+			- `trackN.mcfunction`
+
+	如图，其中，`index.mcfunction`文件和`mscply`文件夹存在于函数目录的根下；在`mscply`目录中，包含音乐导出的众多音轨播放文件（`trackX.mcfunction`），同时，若生成此包时选择了带有进度条的选项，则会包含`progressShow.mcfunction`文件。
+	
+	`index.mcfunction`用于开始播放，其中包含打开各个音轨对应函数的指令，以及加分指令，这里的加分，是将**播放计分板的值大于等于`1`**的所有**玩家**的播放计分板分数增加`1`。同时，若生成此包时选择了自动重置计分板的选项，则会包含一条重置计分板的指令。
+
+	>	你知道吗？音·创的最早期版本“《我的世界》函数音乐生成器”正是用函数来播放，不过这个版本采取的读入数据的形式大有不同。
+
+2. 结构格式
+
+    无论是音·创生成的是何种结构，`MCSTRUCTURE`还是`BDX`，都会依照此处的格式来生成。此处我们想说明的结构的格式不是结构文件存储的格式，而是结构导出之后方块将如何摆放的问题。结构文件存储的格式这一点，在各个《我的世界》开发的相关网站上都可能会有说明。
+
+	考虑到进行《我的世界》游戏开发时，为了节约常加载区域，很多游戏会将指令区设立为一种层叠式的结构。这种结构会限制每一层的指令系统的高度，但是虽然长宽也是有限的，却仍然比其纵轴延伸得更加自由。
+
+	所以，结构的生成形状依照给定的高度和内含指令的数量决定。其 $Z$ 轴延伸长度为指令方块数量对于给定高度之商的向下取整结果的平方根的向下取整。用数学公式的方式表达，则是：
+	
+	$$MaxZ = \left\lfloor\sqrt{\left\lfloor{\frac{NoC}{MaxH}}\right\rfloor}\right\rfloor$$
+
+	其中，$MaxZ$即生成结构的$Z$轴最大延伸长度，$NoC$表示链结构中所含指令方块的个数，$MaxH$表示给定的生成结构的最大高度。
+
+	我们的结构生成器在生成指令链时，将首先以相对坐标系 $(0, 0, 0)$ （即相对原点）开始，自下向上堆叠高度轴（即 $Y$ 轴）的长，当高度轴达到了限制的高度时，便将 $Z$ 轴向正方向堆叠`1`个方块，并开始自上向下重新堆叠，直至高度轴坐标达到相对为`0`。若当所生成结构的 $Z$ 轴长达到了其最大延伸长度，则此结构生成器将反转 $Z$ 轴的堆叠方向，直至 $Z$ 轴坐标相对为`0`。如此往复，直至指令链堆叠完成。
+	
+##	播放器
+
+以结构生成的文件可以采用多种方式播放，一类播放方式，我们称其为**播放器**，例如**延迟播放器**和**计分板播放器**等等，以后推出的新的播放器，届时也会在此处更新。
+
+为什么要设计这么多播放器？是为了适应不同的播放环境需要。通常情况下，一个音乐中含有多个音符，音符与音符之间存在间隔，这里就产生了不一样的，实现音符间时间间隔的方式。而不同的应用环境下，又会产生不一样的要求。接下来将对不同的播放器进行详细介绍。
+
+1.	计分板播放器
+
+	计分板播放器是一种传统的《我的世界》音乐播放方式。通过对于计分板加分来实现播放不同的音符。一个很简单的原理，就是**用不同的计分板分值对应不同的音符**，再通过加分，来达到那个分值，即播放出来。
+
+	在**音·创**中，用来达到这种效果的指令是这样的：
+
+	```mcfunction
+	execute @a[scores={ScBd=x}] ~ ~ ~ playsound InstID @s ~ ~Ht ~ Vlct Ptc
+	```
+
+	|参数|说明|备注|
+	|--------|-----------|----------|
+	|`ScBd`|指定的计分板名称||
+	|`x`|音发出时对应的分数值||
+	|`InstID`|声音效果ID|不同的声音ID可以对应不同的乐器，详见转换[乐器对照表](./%E8%BD%AC%E6%8D%A2%E4%B9%90%E5%99%A8%E5%AF%B9%E7%85%A7%E8%A1%A8.md)|
+	|`Ht`|播放点对玩家的距离|通过距离来表达声音的响度。以 $S$ 表示此参数`Ht`，以Vol表示音量百分比，则计算公式为： $S = \frac{1}{Vol}-1$ |
+	|`Vlct`|原生我的世界中规定的播放力度|这个参数是一个谜一样的存在，似乎它的值毫不重要……因为无论这个值是多少，我们听起来都差不多。当此音符所在MIDI通道为第一通道，则这个值为0.7倍MIDI指定力度，其他则为0.9倍。|
+	|`Ptc`|音符的音高|这是决定音调的参数。以 $P$ 表示此参数， $n$ 表示其在MIDI中的编号， $x$ 表示一定的音域偏移，则计算公式为： $P = 2^\frac{n-60-x}{12}$ |
+
+	后四个参数决定了这个音的性质，而前两个参数仅仅是为了决定音播放的时间。
+
+2.	延迟播放器
+
+	延迟播放器是通过《我的世界》游戏中，指令方块的设置项“延迟刻数”来达到定位音符的效果。**将所有的音符依照其播放时距离乐曲开始时的时间（毫秒），放在一个序列内，再计算音符两两之间对应的时间差值，转换为《我的世界》内对应的游戏刻数之后填入指令方块的设置中。**
+
+	在音·创中，由于此方式播放的音乐不需要用计分板，所以播放指令是这样的：
+
+	```mcfunction
+	execute Tg ~ ~ ~ playsound InstID @s ~ ~Ht ~ Vlct Ptc
+	```
+
+	|参数|说明|备注|
+	|--------|-----------|----------|
+	|`Tg`|播放对象|选择器或玩家名|
+	|`InstID`|声音效果ID|不同的声音ID可以对应不同的乐器，详见转换[乐器对照表](./%E8%BD%AC%E6%8D%A2%E4%B9%90%E5%99%A8%E5%AF%B9%E7%85%A7%E8%A1%A8.md)|
+	|`Ht`|播放点对玩家的距离|通过距离来表达声音的响度。以 $S$ 表示此参数`Ht`，以Vol表示音量百分比，则计算公式为： $S = \frac{1}{Vol}-1$ |
+	|`Vlct`|原生我的世界中规定的播放力度|这个参数是一个谜一样的存在，似乎它的值毫不重要……因为无论这个值是多少，我们听起来都差不多。当此音符所在MIDI通道为第一通道，则这个值为0.7倍MIDI指定力度，其他则为0.9倍。|
+	|`Ptc`|音符的音高|这是决定音调的参数。以 $P$ 表示此参数， $n$ 表示其在MIDI中的编号，$x$表示一定的音域偏移，则计算公式为： $P = 2^\frac{n-60-x}{12}$ |
+
+	其中后四个参数决定了这个音的性质。
+	
+	由于这样的延迟数据是依赖于指令方块的设置项，所以使用这种播放器所转换出的结果仅可以存储在包含方块NBT信息及方块实体NBT信息的结构文件中，或者直接输出至世界。
+
+
+
+# 进度条自定义
+
+因为我们提供了可以自动转换进度条的功能，因此在这里给出进度条自定义参数的详细解释。
+
+请注意，并非所有的演示样例程序都支持自定义进度条。
+
+一个进度条，明显地，有**固定部分**和**可变部分**来构成。而可变部分又包括了文字和图形两种（当然，《我的世界》里头的进度条，可变的图形也就是那个“条”了）。这一点你需要了解，因为后文中包含了很多这方面的概念需要你了解。
+
+进度条的自定义功能使用一个字符串来定义自己的样式，其中包含众多**标识符**来表示可变部分。
+
+标识符如下（注意大小写）：
+
+| 标识符   | 指定的可变量     |
+|---------|----------------|
+| `%%N`   | 乐曲名(即传入的文件名)|
+| `%%s`   | 当前计分板值     |
+| `%^s`   | 计分板最大值     |
+| `%%t`   | 当前播放时间     |
+| `%^t`   | 曲目总时长       |
+| `%%%`   | 当前进度比率     |
+| `_`     | 用以表示进度条占位|
+
+表示进度条占位的 `_` 是用来标识你的进度条的。也就是可变部分的唯一的图形部分。
+
+**样式定义字符串**的样例如下，这也是默认的进度条的样式：
+
+`▶ %%N [ %%s/%^s %%% __________ %%t|%^t]`
+
+这是单独一行的进度条，当然你也可以制作多行的，如果是一行的，输出时所使用的指令便是 `title`，而如果是多行的话，输出就会用 `titleraw` 作为进度条字幕。
+
+哦对了，上面的只不过是样式定义，同时还需要定义的是可变图形的部分，也就是进度条上那个真正的“条”。
+
+对于这个我们就采用了固定参数的方法，对于一个进度条，无非就是“已经播放过的”和“没播放过的”两种形态，所以，使用一个元组来传入这两个参数就是最简单的了。元组的格式也很简单：`(str: 播放过的部分长啥样, str: 没播放过的部分长啥样)` 。例如，我们默认的进度“条”的定义是这样的：
+
+`('§e=§r', '§7=§r')`
+
+综合起来，把这些参数传给函数需要一个参数整合，你猜用的啥？啊对对对，我用的还是元组！
+
+我们的默认定义参数如下：
+
+`(r'▶ %%N [ %%s/%^s %%% __________ %%t|%^t]',('§e=§r', '§7=§r'))`
+
+*对了！为了避免生成错误，请尽量避免使用标识符作为定义样式字符串的其他部分*
+

docs/生成文件的使用说明.md

@@ -0,0 +1,48 @@
+<h1 align="center">音·创 Musicreater</h1>
+
+<h2 align="center">库版 Package Version</h2>
+
+<p align="center">
+<img width="128" height="128" src="https://s1.ax1x.com/2022/05/06/Ouhghj.md.png" >
+</p>
+
+#	生成文件的使用
+
+*由于先前的 **读我文件**(README.md) 过于冗杂，现另辟蹊径来给大家全方位的教程。*
+
+*这是本库所生成文件的使用声明，不是使用本库的教程，若要查看**本库的演示程序**使用教程，可点击[此处](%E5%8A%9F%E8%83%BD%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md)；若要查看有关文件结构的内容，可以点击[此处](./%E7%94%9F%E6%88%90%E6%96%87%E4%BB%B6%E7%BB%93%E6%9E%84%E8%AF%B4%E6%98%8E.md)*
+
+##	附加包格式
+
+支持的文件后缀：`.MCPACK`
+
+1.	导入附加包
+2.	在一个循环方块中输入指令 `function index`
+3.	将需要聆听音乐的实体的播放所用计分板设置为 `1`
+4.	激活循环方块
+5.	若想要暂停播放，可以停止循环指令方块的激活状态
+6.	若想要重置某实体的播放，可以将其播放用的计分板重置
+
+>	其中 步骤三 和 步骤四 的顺序可以调换。
+
+##	结构格式
+
+支持的文件后缀：`.MCSTRUCTURE`、`.BDX`
+
+1.	将结构导入世界
+
+-	延迟播放器
+	
+	2.	将结构生成的第一个指令方块之模式更改为**脉冲**
+	3.	激活脉冲方块
+	4.	若欲重置播放，可以停止对此链的激活，例如停止区块加载
+	5.	此播放器不支持暂停
+
+-	计分板播放器
+
+	2.	在所生成的第一个指令方块前，放置一个循环指令方块，其朝向应当对着所生成的第一个方块
+	3.	在循环指令方块中输入使播放对象的播放用计分板加分的指令，延迟为`0`，每次循环增加`1`分
+	4.	激活循环方块
+	5.	若想要暂停播放，可以停止循环指令方块的激活状态
+	6.	若想要重置某实体的播放，可以将其播放用的计分板重置
+

docs/转换乐器对照表.md

@@ -0,0 +1,2 @@
+
+# 暂无

example.py

@@ -0,0 +1,149 @@
+# -*- coding: utf-8 -*-
+
+# 伶伦 开发交流群 861684859
+
+
+"""
+音·创 (Musicreater) 演示程序
+是一款免费开源的针对《我的世界》的midi音乐转换库
+Musicreater (音·创)
+A free open source library used for convert midi file into formats that is suitable for **Minecraft**.
+
+版权所有 © 2023 音·创 开发者
+Copyright © 2023 all the developers of Musicreater
+
+开源相关声明请见 ./License.md
+Terms & Conditions: ./License.md
+"""
+
+import os
+import Musicreater
+
+
+# 获取midi列表
+midi_path = input(f"请输入MIDI路径：")
+
+
+# 获取输出地址
+out_path = input(f"请输入输出路径：")
+
+conversion = Musicreater.midiConvert()
+
+
+def isMethodOK(sth: str):
+    if int(sth) in range(1, len(conversion.methods) + 1):
+        return int(sth)
+    else:
+        raise ValueError
+
+
+convert_method = int(input(f"请输入转换算法[1~{len(conversion.methods)}]："))
+
+# 选择输出格式
+fileFormat = int(input(f"请输入输出格式[BDX(1) 或 MCPACK(0)]：").lower())
+playerFormat = int(input(f"请选择播放方式[计分板(1) 或 延迟(0)]：").lower())
+
+
+# 真假字符串判断
+def bool_str(sth: str) -> bool:
+    try:
+        return bool(float(sth))
+    except ValueError:
+        if str(sth).lower() == "true":
+            return True
+        elif str(sth).lower() == "false":
+            return False
+        else:
+            raise ValueError("布尔字符串啊？")
+
+
+debug = False
+
+if os.path.exists("./demo_config.json"):
+    import json
+
+    prompts = json.load(open("./demo_config.json", "r", encoding="utf-8"))
+    if prompts[-1] == "debug":
+        debug = True
+    prompts = prompts[:-1]
+else:
+    prompts = []
+    # 提示语 检测函数 错误提示语
+    for args in [
+        (
+            f"输入音量：",
+            float,
+        ),
+        (
+            f"输入播放速度：",
+            float,
+        ),
+        (
+            f"是否启用进度条：",
+            bool_str,
+        ),
+        (
+            f"计分板名称：",
+            str,
+        )
+        if playerFormat == 1
+        else (
+            f"玩家选择器：",
+            str,
+        ),
+        (
+            f"是否自动重置计分板：",
+            bool_str,
+        )
+        if playerFormat == 1
+        else (),
+        (
+            f"作者名称：",
+            str,
+        )
+        if fileFormat == 1
+        else (),
+        (
+            f"最大结构高度：",
+            int,
+        )
+        if fileFormat == 1
+        else (),
+    ]:
+        if args:
+            prompts.append(args[1](input(args[0])))
+
+conversion = Musicreater.midiConvert(debug=debug)
+
+
+print(f"正在处理 {midi_path} ：")
+conversion.convert(midi_path, out_path)
+if debug:
+    with open("./records.json", "a", encoding="utf-8") as f:
+        json.dump(conversion.toDICT(), f)
+        f.write(5 * "\n")
+conversion_result = (
+    conversion.to_mcpack(convert_method, *prompts)
+    if fileFormat == 0
+    else (
+        conversion.to_BDX_file(convert_method, *prompts)
+        if playerFormat == 1
+        else conversion.to_BDX_file_with_delay(convert_method, *prompts)
+    )
+)
+
+if conversion_result[0]:
+    print(
+        f"	指令总长：{conversion_result[1]}，最高延迟：{conversion_result[2]}{f'''，结构大小{conversion_result[3]}，最末坐标{conversion_result[4]}''' if fileFormat == 1 else ''}"
+    )
+else:
+    print(f"失败：{conversion_result}")
+
+exitSth = input("回车退出").lower()
+if exitSth == "record":
+    import json
+
+    with open("./demo_config.json", "w", encoding="utf-8") as f:
+        json.dump(prompts, f)
+elif exitSth == "delrec":
+    os.remove("./demo_config.json")

example_mcstructure.py

@@ -0,0 +1,8 @@
+from Musicreater import midiConvert
+
+conversion = midiConvert(enable_old_exe_format=False)
+conversion.convert(input("midi路径:"), input("输出路径:"))
+
+conversion.to_mcstructure_file_with_delay(
+    3,
+)

fcwslib/__init__.py

@@ -1,170 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：2个---未解决；警告（二级）错误：2个；语法（一级）错误：17个
-
-
-__version__ = '0.0.1'
-__all__ = []
-__author__ = 'Fuckcraft <https://gitee.com/fuckcraft>'
-
-'''
-Fuckcraft Websocket Library (FCWSLIB)
-A library to develop minecraft websocket server easily.
-
-    Copyright (C) 2021 Fuckcraft
-
-    This program is free software: you can redistribute it and/or modify
-    it under the terms of the GNU Affero General Public License as
-    published by the Free Software Foundation, either version 3 of the
-    License, or (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU Affero General Public License for more details.
-'''
-
-from main import *
-
-# import os
-import json
-import uuid
-# import logging
-import asyncio
-import time
-import websockets
-
-
-# 写这段代码的时候，只有我和上帝知道这段代码是干什么的。
-# 现在只有上帝知道。
-# ----
-# 没毛病，我讨厌两种人：一种是要我写注释的人，一种是给我代码看但没有写注释的人。
-
-# 此函数用于向 Minecraft 订阅请求
-async def subscribe(websocket, event_name):
-    """
-    参数:
-    : websocket  : websocket 对象 :
-    : event_name : 需要订阅的请求 :
-
-    返回:
-    None
-    """
-
-    response = {
-        'body': {
-            'eventName': str(event_name)  # 示例：PlayerMessage
-        },
-        'header': {
-            'requestId': str(uuid.uuid4()),
-            'messagePurpose': 'subscribe',
-            'version': 1,
-            'messageType': 'commandRequest'
-        }
-    }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-
-# 此函数用于向 Minecraft 消除订阅请求
-async def unsubscribe(webscket):
-    """
-    参数:
-    : websocket  : websocket 对象     :
-    : event_name : 需要消除订阅的请求 :
-
-    返回:
-    None
-    """
-    print(webscket)
-
-    response = {
-        "body": {
-            "eventName": str(event_name)  # PlayerMessage
-        },
-        "header": {
-            "requestId": str(uuid.uuid4()),
-            "messagePurpose": "unsubscribe",
-            "version": 1,
-            "messageType": "commandRequest"
-        }
-    }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-
-# 此函数用于向 Minecraft 执行命令
-async def send_command(websocket, command):
-    """
-    参数:
-    : websocket : websocket 对象 :
-    : command   : 执行的命令     :
-
-    返回:
-    None
-    """
-
-    response = {
-        'body': {
-            'origin': {
-                'type': 'player'
-            },
-            'commandLine': str(command),
-            'version': 1
-        },
-        'header': {
-            'requestId': str(uuid.uuid4()),
-            'messagePurpose': 'commandRequest',
-            'version': 1,
-            'messageType': 'commandRequest'
-        }
-    }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-
-# 此函数用于向 Minecraft 发送消息
-async def tellraw(websocket, message):
-    """
-    参数:
-    : websocket : websocket 对象 :
-    : message   : 发送的消息     :
-
-    返回:
-    None
-    """
-
-    command = {
-        'rawtext': [
-            {
-                'text': '[{}] {}'.format(time.asctime(), message)
-            }
-        ]
-    }
-
-    # 增加 json 可读性
-    # command = json.dumps(command, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    command = json.dumps(command)
-    command = 'tellraw @a {}'.format(command)
-
-    await send_command(websocket, command)
-
-
-def run_server(function):
-    # 修改 ip 地址和端口
-    start_server = websockets.serve(function, 'localhost', 8080)
-    asyncio.get_event_loop().run_until_complete(start_server)
-    asyncio.get_event_loop().run_forever()

fcwslib/main.py

@@ -1,160 +0,0 @@
-#!/usr/bin/python
-# -*- coding: utf-8 -*-
-
-__version__ = '0.0.1'
-__all__ = ['run_server', 'subscribe', 'unsubscribe', 'send_command', 'tellraw']
-__author__ = 'Fuckcraft <https://gitee.com/fuckcraft>'
-
-'''
-Fuckcraft Websocket Library (FCWSLIB)
-A library to develop minecraft websocket server easily.
-
-    Copyright (C) 2021 Fuckcraft
-
-    This program is free software: you can redistribute it and/or modify
-    it under the terms of the GNU Affero General Public License as
-    published by the Free Software Foundation, either version 3 of the
-    License, or (at your option) any later version.
-
-    This program is distributed in the hope that it will be useful,
-    but WITHOUT ANY WARRANTY; without even the implied warranty of
-    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-    GNU Affero General Public License for more details.
-'''
-
-import os
-import json
-import uuid
-import logging
-import asyncio
-import time
-import websockets
-
-# 写这段代码的时候，只有我和上帝知道这段代码是干什么的。
-# 现在只有上帝知道。
-
-# 此函数用于向 Minecraft 订阅请求
-async def subscribe(websocket, event_name):
-    '''
-    输入:
-    : websocket  : websocket 对象 :
-    : event_name : 需要订阅的请求 :
-
-    输出:
-    None
-    '''
-
-    response = {
-            'body': {
-                'eventName': str(event_name)  # 示例：PlayerMessage
-            },
-            'header': {
-                'requestId': str(uuid.uuid4()),
-                'messagePurpose': 'subscribe',
-                'version': 1,
-                'messageType': 'commandRequest'
-            }
-        }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-    
-    await websocket.send(response)
-
-# 此函数用于向 Minecraft 消除订阅请求
-async def unsubscribe(webscket):
-    '''
-    输入:
-    : websocket  : websocket 对象     :
-    : event_name : 需要消除订阅的请求 :
-
-    输出:
-    None
-    '''
-
-    response = {
-            "body": {
-                "eventName": str(event_name)  # 示例：PlayerMessage
-            },
-            "header": {
-                "requestId": str(uuid.uuid4()),
-                "messagePurpose": "unsubscribe",
-                "version": 1,
-                "messageType": "commandRequest"
-            }
-        }
-    
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-# 我个人不负责这块的质量，因为他们逼迫我违心的写了这段代码
-
-# 此函数用于向 Minecraft 执行命令
-async def send_command(websocket, command):
-    '''
-    输入:
-    : websocket : websocket 对象 :
-    : command   : 执行的命令     :
-
-    输出:
-    None
-    '''
-
-    response = {
-            'body': {
-                'origin': {
-                    'type': 'player'
-                },
-                'commandLine': str(command),
-                'version': 1
-            },
-            'header': {
-                'requestId': str(uuid.uuid4()),
-                'messagePurpose': 'commandRequest',
-                'version': 1,
-                'messageType': 'commandRequest'
-            }
-        }
-
-    # 增加 json 的可读性
-    # response = json.dumps(response, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    response = json.dumps(response)
-
-    await websocket.send(response)
-
-# 此函数用于向 Minecraft 发送消息
-async def tellraw(websocket, message):
-    '''
-    输入:
-    : websocket : websocket 对象 :
-    : message   : 发送的消息     :
-
-    输出:
-    None
-    '''
-
-    command = {
-            'rawtext':[
-                {
-                    'text':'[{}] {}'.format(time.asctime(), message)
-                }
-            ]
-        }
-
-    # 增加 json 可读性
-    # command = json.dumps(command, sort_keys=True, indent=4, separators=(', ', ': '), ensure_ascii=False)
-    command = json.dumps(command)
-    command = 'tellraw @a {}'.format(command)
-
-    await send_command(websocket, command)
-
-def run_server(function):
-    # 修改 ip 地址和端口
-    start_server = websockets.serve(function, 'localhost', 8080)
-    asyncio.get_event_loop().run_until_complete(start_server)
-    asyncio.get_event_loop().run_forever()
-

languages/const2string.py

@@ -1,96 +0,0 @@
-# -*- coding:utf-8 -*-
-
-
-# W-YI 金羿
-# QQ 2647547478
-# 音·创 开发交流群 861684859
-# Email EillesWan2006@163.com W-YI_DoctorYI@outlook.com EillesWan@outlook.com
-# 版权所有 Team-Ryoun 金羿
-# 若需转载或借鉴 请附作者
-
-
-"""
-   Copyright 2022 Eilles Wan (金羿)
-
-   Licensed under the Apache License, Version 2.0 (the 'License')
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an 'AS IS' BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
-"""
-
-#  代码写的并非十分的漂亮，还请大佬多多包涵；本软件源代码依照Apache软件协议公开
-
-# -----------------------------分割线-----------------------------
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：12个
-# 目前我的Pycharm并没有显示任何错误，有错误可以向：
-# bgArray 诸葛亮与八卦阵
-# QQ 474037765 或最好加入：音·创 开发交流群 861684859
-# ------------------------- split line-----------------------------
-# Zhuge Liang and Bagua array help to modify the grammar date: -- January 19, 2022
-# Statistics: fatal (Level 3) errors: 0; Warning (Level 2) errors: 15; Syntax (Level 1) error: 597
-# At present, my Pycham does not display any errors. If there are errors, you can report them to me
-# Bgarray Zhuge Liang and Bagua array
-# QQ 474037765 or better join: Musicreater development exchange group 861684859
-# ------------------------- split line-----------------------------
-
-# 下面为正文
-
-
-# 将程序中用双引号""括起来的字符串
-# 转为字符串列表 list[str, str, ...]
-# 方便进行语言翻译支持。
-
-import sys
-startWith = 0
-
-
-def __main__():
-    textList = []
-    for fileName in sys.argv[1:]:
-        print('读取文件: {}'.format(fileName))
-        fileText = []
-        for line in open(fileName, 'r', encoding='utf-8'):
-            while line.count('"') >= 2:
-                # 只有上帝看得懂我在写什么。
-                if line[
-                   line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])] in textList:
-                    thisText = textList.index(
-                        line[line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])])
-                else:
-                    thisText = len(textList)
-                    textList.append(
-                        line[line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])])
-                line = line.replace(
-                    line[line.index('"'):2 + line[line.index('"') + 1:].index('"') + len(line[:line.index('"')])],
-                    'READABLETEXT[{}]'.format(thisText + startWith)
-                )
-            fileText.append(line)
-
-        open(fileName + '_C', 'w', encoding='utf-8').writelines(fileText)
-
-    outFile = open('lang__.py', 'w', encoding='utf-8')
-    outFile.write('''# -*- coding:utf-8 -*-
-
-# 由金羿翻译工具生成字符串列表
-# 请在所需翻译文件前from 此文件 import READABLETEXT
-
-
-
-READABLETEXT = {
-''')
-    for i in range(len(textList)):
-        outFile.write("    {}:{},\n".format(i + startWith, textList[i]))
-    outFile.write('}')
-    outFile.close()
-
-
-if __name__ == '__main__':
-    __main__()

languages/enGB.py

@@ -1,180 +0,0 @@
-# -*- coding:utf-8 -*-
-
-# 由金羿翻译工具生成字符串列表
-# 请在所需翻译的文件前from 此文件 import READABLETEXT
-
-
-READABLETEXT = {
-    'Translator': (("Eilles Wan (金羿)", True),),
-    # 此处是语言翻译者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    0: "ERROR❌",
-    1: "TIPS❗",
-    2: "Clearing log(this wont be in the file)",
-    3: "Could not clear the temporary files or logs",
-    4: "saved",
-    5: "New Musicreater Project",
-    6: "Select old-type project",
-    7: "Select Musicreater Project",
-    8: "Cant open:{}, please check if youve entered the right name",
-    9: "Musicreat - About",
-    10: "Musicreater",
-    11: "Ver. {}",
-    12: """Team-Ryoun for Minecraft\n×\nTeam-Ryoun for Software Development""",
-    13: "OK",
-    14: "Inpute Notes",
-    15: (("- Developers -", False),
-         ("Eilles Wan (金羿)", True), ("EillesWan@outlook.com", False), ("QQ 2647547478", False),
-         ("bgArray “诸葛亮与八卦阵”", True), ("QQ 474037765", False)),
-    # 此处是开发者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    16: "- Translators -",
-    # 17:"",
-    18: "QQ Group: 861684859",
-    19: "Musicreater - Help",
-    20: "Select sound file",
-    21: "Select MIDI file",
-    22: "Select NoteText file",
-    23: "Get Note info",
-    24: "Write in Note info: {}",
-    25: "Select generating file",
-    26: "Select generating folder",
-    27: "Select generating .mcpack file",
-    28: "Input position info",
-    29: "Select generating world folder",
-    30: "Select generating Function Pack",
-    31: "Select .mcfunction file ",
-    32: "Select .bdx file ",
-    33: "DONE✔",
-    34: "Input playing rate",
-    35: "Generating",
-    36: "Select a world folder",
-    37: "Make sure",
-    38: "Generate .RyStruct file",
-    39: "FAILED❌",
-    40: "Report message inpution",
-    41: "Musicreater - {}",
-    42: "ExecutingEntityName: {}",
-    43: "ScoreboardName: {}",
-    44: "Instrument: {}",
-    45: "TrackName: {}",
-    46: "PackName: {}",
-    47: "MusicTitle: {}",
-    48: "IsRepeat?: {}",
-    49: "Player'sTargetSelector: {}",
-    50: "Modify Main Option",
-    51: "Modify Track Option",
-    52: "Default Instrument: Enter English\n",
-    53: "Open...",
-    54: "Open Old Project...",
-    55: "Save",
-    56: "Save as...",
-    57: "Exit",
-    58: "File",
-    59: "Load tracks from sound",
-    60: "Load tracks from Midi",
-    61: "Load tracks from Text",
-    62: "Input notes to track",
-    63: "Edit",
-    64: "Generate file...",
-    65: "Generate function pack...",
-    66: "Generate .mcpack file...",
-    67: "Functions(Pack)",
-    68: "Save music as blocks into a map",
-    69: "Save music as blocks into a exist map...",
-    70: "Save music as commands into a map",
-    71: "Save music as commands into a exist map...",
-    72: "Save music as notebox into a map",
-    73: "Save music as notebox into a exist map...",
-    74: "World",
-    75: "Generate a function that fits current music...",
-    76: "Export selected track as commands in .bdx...",
-    77: "Export .bdx file from map...",
-    78: "Export .RyStruct file from map...",
-    79: "Load functions into a world...",
-    80: "Separate long .mcfunction file into small ones and set them into a world as a chain...",
-    81: "Additional Functions",
-    82: "Show generating result",
-    83: "Set a websocket server on localhost:8080 and play the selected track",
-    84: "Experimental Functions",
-    85: "Clear log file",
-    86: "Clear save file(obsolete)",
-    87: "Help",
-    88: "About",
-    89: "Send a bug report",
-    90: "Q&A",
-    91: "Main Options",
-    92: "Export music as .BDX...",
-    93: "请输入指令链生成最高相对高度(≥5)",
-    94: "❌You should input a number which is not lower then 4, please reinput again.",
-    95: "Structure",
-    96: "Reset Main Options",
-    97: "Track Options",
-    # 98:"",
-    # 99:"",
-    # 100:"",
-    # 101:"",
-    102: "Delete Selected Track",
-    # 103:"",
-    # 104:"",
-
-    105: "Error with finding or reading file😢：{}",
-    106: "Project is unsaved, save before close?",
-    107: "Saved in: {}",
-    108: ("Musicreater 0.0.X Project","Musicreater 0.1+ Project","Musicreater 0.1+ TESTver Project"),
-    109: "Any Type",
-    110: "NoteFunCreater Project",
-    111: "MMFM (V0.0.6) Project",
-    112: "All Types",
-    113: ".MP3 file(piano sound)",
-    114: "Midi file",
-    115: "Text file",
-    116: "Position Inpution",
-    117: "Format Error❌, please Reinput!",
-    118: ".MCFUNCTION",
-    119: "The position of the ChainCB for execution:",
-    # 120: "",
-    121: "您的函数文件不大于一万条指令，无需进行分割操作。",
-    122: "请输入执行链生成相对坐标：",
-    123: "FastBuilder Structure",
-    124: "Done!\n{}",
-    125: "一秒，音乐走几拍？",
-    126: "按下确认后，在游戏中使用connect指令连接localhost:8080，即可播放",
-    127: "请输入区域选择的开始坐标：",
-    128: "请输入区域选择的结束坐标：",
-    129: "Whether air block remain when export?",
-    130: "Musicreater Structure",
-    131: "Done😃\n{}",
-    132: "Failed❌\n{}\n{}",
-    133: "Have not developed yet...",
-    134: "Your name",
-    135: "Your contact",
-    136: "Your description of Problem",
-    137: "Log file will be cleared when you exit.",
-    138: "Log file will NOT be cleared when you exit.",
-    139: "修改包名",
-    140: "修改音乐标题",
-    141: "修改玩家选择器\n注意！要加上中括号“[]”",
-    142: "修改本音轨的执行实体名",
-    143: "修改本音轨所用的积分板",
-    144: "修改本音轨所用乐器",
-    145: "您输入的乐器并非游戏内置乐器，是否继续用您输入的字符作为乐器？",
-    146: "修改本音轨生成的文件名",
-    # -----2022.1.25更新
-    147: "生成新文件至...",
-    148: "从midi导入音轨且用新方法解析",
-    149: "Open New: Musicreater Project...",
-    150: "保存为新项目",
-    151: "另存为新项...",
-    152: "（开发调试）关闭本次日志记录",
-    153: "生成新函数包至...",
-    154: "生成新函数附加包文件至...",
-    155: "生成新函数附加包文件，并将神羽资源包以散包形式放置至...",
-    156: "Select [MiraclePlumeResourcePack]...",
-    157: "没有路径文件(.rpposi文件)，请仔细阅读Readme或先试用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 方法添加路径文件吧！",
-    158: "有路径文件(.rpposi文件)，但路径指示错误，请仔细阅读Readme或先用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 更改路径！",
-    159: "更改路径文件(.rpposi文件)成功！！",
-    160: "从midi导入音轨且用类方法解析",
-    161: "打开 类方法： 音·创项目...",
-    162: "保存为类方法项目",
-    163: "另存为类方法项...",
-
-}

languages/lang.py

@@ -1,20 +0,0 @@
-# -*- coding:utf-8 -*-
-
-
-DEFAULTLANGUAGE = 'zh-CN'
-
-LANGUAGELIST = {
-    'zh-CN': (
-        "简体中文 中国大陆",
-        "Simplified Chinese, China Mainland",
-    ),
-    'en-GB': (
-        "英式英语 大不列颠",
-        "British English, Great Britain",
-    ),
-}
-
-if DEFAULTLANGUAGE == 'zh-CN':
-    from languages.zhCN import READABLETEXT
-elif DEFAULTLANGUAGE == 'en-GB':
-    from languages.enGB import READABLETEXT

languages/zhCN.py

@@ -1,185 +0,0 @@
-# -*- coding:utf-8 -*-
-
-# 由金羿翻译工具生成字符串列表
-# 请在所需翻译文件前from 此文件 import READABLETEXT
-
-
-READABLETEXT = {
-    'Translator': (("金羿 Eilles 原稿", True),),
-    # 此处是语言翻译者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    0: "错误❌",
-    1: "提示❗",
-    2: "清除log（此句不载入日志）",
-    3: "无法清除日志及临时文件",
-    4: "已存储",
-    5: "新建 音·创 项目",
-    6: "请选择旧类型的项目",
-    7: "请选择 音·创 项目",
-    8: "无法打开文件：{}，请查看您是否输入正确",
-    9: "音·创 - 关于",
-    10: "音·创 Musicreater",
-    11: "当前版本：{}",
-    12: """凌云我的世界开发团队\n×\n凌云计算机应用软件开发团队""",
-    13: "确定",
-    14: "请输入音符",
-    15: (("- 开发者 -", False),
-         ("金羿 Eilles", True), ("EillesWan@outlook.com", False), ("QQ 2647547478", False),
-         ("bgArray “诸葛亮与八卦阵”", True), ("QQ 474037765", False),
-         ),
-    # 此处是开发者列表，其中每个元组第一项为显示文本，第二项为此文本是否为开发者名字
-    16: "- 翻译者 -",
-    # 17:"",
-    18: "讨论群: 861684859",
-    19: "音·创 - 帮助",
-    20: "请选择钢琴声音的音乐文件",
-    21: "请选择 MIDI 文件",
-    22: "请选择 音符文本 文件",
-    23: "获取音符信息",
-    24: "音符数据写入{}",
-    25: "请选择文件生成的位置",
-    26: "请选择文件夹生成的位置",
-    27: "请选择.mcpack文件生成的位置",
-    28: "坐标信息输入",
-    29: "请选择世界文件夹生成的位置",
-    30: "请选择函数包生成的位置",
-    31: "请选择 .mcfunction 文件",
-    32: "请选择需要生成的.bdx文件",
-    33: "完成✔",
-    34: "输入播放速度",
-    35: "创建中",
-    36: "请选择世界文件夹所在的位置",
-    37: "请确认",
-    38: "生成.RyStruct文件",
-    39: "失败❌",
-    40: "邮件反馈信息输入",
-    41: "音·创 - {}",
-    42: "执行实体名：{}",
-    43: "使用计分板：{}",
-    44: "所用的乐器：{}",
-    45: "当前音轨名：{}",
-    46: "包名：{}",
-    47: "音乐标题：{}",
-    48: "是否重复：{}",
-    49: "玩家选择器：{}",
-    50: "修改主设置",
-    51: "修改节设置",
-    52: "游戏内置乐器如下：请输入英文\n",
-    53: "打开音·创项目...",
-    54: "打开旧项目...",
-    55: "保存项目",
-    56: "另存为...",
-    57: "退出",
-    58: "文件",
-    59: "从钢琴MP3导入音轨",
-    60: "从midi导入音轨",
-    61: "从文本文件导入音轨",
-    62: "输入音符至音轨",
-    63: "编辑",
-    64: "生成文件至...",
-    65: "生成函数包至...",
-    66: "生成附加包文件至...",
-    67: "函数(包)",
-    68: "将音乐以方块存储生成地图",
-    69: "将音乐以方块存储载入地图…",
-    70: "将音乐以指令存储生成地图",
-    71: "将音乐以指令存储载入地图…",
-    72: "将音乐以音符盒存储生成地图",
-    73: "将音乐以音符盒存储载入地图…",
-    74: "世界",
-    75: "生成符合当前音乐的函数播放器…",
-    76: "将选中音轨以指令存储生成.bdx文件…",
-    77: "由地图导出至.bdx文件…",
-    78: "由地图导出至.RyStruct文件…",
-    79: "将函数载入世界…",
-    80: "将大函数分割并建立执行链…",
-    81: "辅助功能",
-    82: "展示生成结果",
-    83: "建立位于localhost:8080上的websocket服务器播放选中音轨",
-    84: "实验性功能",
-    85: "清除日志文件",
-    86: "清除早期版本的存储文件",
-    87: "帮助",
-    88: "关于",
-    89: "发送错误日志反馈",
-    90: "帮助与疑问",
-    91: "音乐总设置(项目设置)",
-    # =============================================================此处有新增
-    92: "将音乐导出为BDX",
-    93: "请输入指令链生成最高相对高度(≥5)",
-    94: "您输入的数据有误❌，相对高度请输入一个不小于4的值，请重新输入。",
-    95: "结构操作",
-    96: "重置项目设置",
-    97: "当前音轨设置(段落设置)",
-    # 98:"",
-    # 99:"",
-    # 100:"",
-    # 101:"",
-    102: "删除选中音轨",
-    # 103:"",
-    # 104:"",
-    105: "找不到或无法读取文件😢：{}",
-    106: "您当前的项目已修改但未存储，是否先保存当前项目？",
-    107: "项目已经存储至：{}",
-    108: ("音·创0.0.X工程文件", "音·创0.1+工程文件", "音·创0.1+TEST工程文件"),
-    109: "任意类型",
-    110: "函数音创工程文件",
-    111: "MMFM0.0.6版本工程文件",
-    112: "全部类型",
-    113: "钢琴声音的音频文件",
-    114: "Midi文件",
-    115: "文本文件",
-    116: "请输入坐标：",
-    117: "您输入的格式有误❌，请重新输入。",
-    118: "我的世界指令函数文件",
-    119: "请输入执行链生成坐标：",
-    # 120: "",
-    121: "您的函数文件不大于一万条指令，无需进行分割操作。",
-    122: "请输入执行链生成相对坐标：",
-    123: "FastBuilder结构文件",
-    124: "转换结束！\n{}",
-    125: "一秒，音乐走几拍？",
-    126: "按下确认后，在游戏中使用connect指令连接localhost:8080，即可播放",
-    127: "请输入区域选择的开始坐标：",
-    128: "请输入区域选择的结束坐标：",
-    129: "所选区块导出时是否需要保留空气方块？",
-    130: "音·创结构文件",
-    131: "文件已生成\n{}",
-    132: "文件无法生成\n{}\n{}",
-    133: "本功能尚未开发。",
-    134: "您的称呼",
-    135: "您的联系方式",
-    136: "您对问题的描述",
-    137: "在程序结束后将清除日志及临时文件信息。",
-    138: "在程序结束后将不会清除日志及临时文件信息。",
-    139: "修改包名",
-    140: "修改音乐标题",
-    141: "修改玩家选择器\n注意！要加上中括号“[]”",
-    142: "修改本音轨的执行实体名",
-    143: "修改本音轨所用的积分板",
-    144: "修改本音轨所用乐器",
-    145: "您输入的乐器并非游戏内置乐器，是否继续用您输入的字符作为乐器？",
-    146: "修改本音轨生成的文件名",
-    # -----2022.1.25更新
-    147: "生成乐器文件至...",
-    148: "从midi导入音轨且用新方法解析",
-    # 149: "打开 新： 音·创项目...",
-    # 150: "保存为新项目",
-    # 151: "另存为新项...",
-    152: "（开发调试）关闭本次日志记录",
-    153: "生成乐器函数包至...",
-    154: "生成乐器函数附加包文件至...",
-    155: "生成乐器函数附加包文件，并将神羽资源包以散包形式放置至...",
-    156: "[神羽资源包位置选择]：选择文件夹...",
-    157: "没有路径文件(.rpposi文件)，请仔细阅读Readme或先试用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 方法添加路径文件吧！",
-    158: "有路径文件(.rpposi文件)，但路径指示错误，请仔细阅读Readme或先用：帮助与疑问->[神羽资源包位置选择]：选择文件夹... 更改路径！",
-    159: "更改路径文件(.rpposi文件)成功！！",
-    160: "从midi导入音轨且用类方法解析",
-    # 161: "打开 类方法： 音·创项目...",
-    # 162: "保存为类方法项目",
-    # 163: "另存为类方法项...",
-    164: "生成新文件至...",
-    165: "生成新函数包至...",
-    166: "生成新函数附加包文件至...",
-    167: "！！！这个midi文件读取不了，mido解析报错！！！"
-
-}

msctspt/bdxOpera_CP.py

@@ -1,221 +0,0 @@
-import os
-import brotli
-
-'''感谢由 Charlie_Ping “查理平” 带来的bdx转换代码'''
-
-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：7个
-
-
-class BdxConverter:
-    __header = "BD@"
-    __bin_header = b"BDX"
-    __generator_author = b"&Charlie_Ping"
-
-    keys = {
-        # x--, x++, addSmallX(-128~127), addX(-32768~32767), addBigX(-2147483648~2147483647)
-        "x": [b"\x0f", b"\x0e", b"\x1c", b"\x14", b"\x15"],
-        "y": [b"\x11", b"\x10", b"\x1d", b"\x16", b"\x17"],
-        "z": [b"\x13", b"\x12", b"\x1e", b"\x18", b"\x19"],
-        "end": b"\x58",
-        "isSigned": b"\x5a",
-        "placeCommandBlockWithData": b"\x1b",
-        "placeBlock": b"\x07"
-    }
-
-    def __init__(self, file_path: str, author: str, blocks):
-        self.author = author
-        self.blocks = blocks
-        self.file_path = file_path
-        self.direction = [0, 0, 0]
-        self.block_type = self.get_block_type
-        self.__file = self.create_and_upload_file
-
-    @property
-    def get_block_type(self):
-        """
-        blocks
-        [
-            {
-                "direction": [x: int, y: int, z: int],
-                block_name: str,
-                particular_value: int,
-            }
-        ]
-        :return: list 给出的所有方块种类名称
-        """
-        block_type = set()
-        for block_ in self.blocks:
-            block_type.add(block_["block_name"])
-        block_type = list(block_type)
-        return block_type
-
-    @property
-    def create_and_upload_file(self):
-        """
-        （瞎用property？ 害怕
-        创建一个bdx文件
-        要close！
-        :return: 一个文件对象
-        """
-        _dir = os.path.dirname(self.file_path)
-        if not os.path.isdir(_dir):
-            os.makedirs(_dir)
-        _bytes = self.__bin_header
-        _bytes += b"\x00"
-        _bytes += self.author.encode("utf-8") + self.__generator_author
-        for i in self.block_type:
-            _bytes += b"\x00\x01"
-            _bytes += bytes(i, encoding="utf-8")
-        _bytes += b"\x00"
-        _bytes += self.upload_blocks()
-        _bytes += b"X"
-        with open(self.file_path, "w+") as f:
-            f.write("BD@")
-            f.close()
-        with open(self.file_path, "ab+") as f:
-            f.write(brotli.compress(_bytes))
-            f.close()
-        return
-
-    def upload_blocks(self):
-        """
-        计算差值
-        写入移动过程
-        写入方块
-        更新差值
-        :return:
-        """
-        _types = b""
-        for block_ in self.blocks:
-            # print(f"当前方块：{block['block_name']}, 位置： {block['direction']}]")
-            diff = self.move_pointer(self.direction, block_["direction"])
-            _types += diff
-            if block_["block_name"] in ["command_block",
-                                        "chain_command_block",
-                                        "repeating_command_block"]:
-                _types += self.obtain_command_block(block_)
-            else:
-                _types += self.obtain_universal_block(block_)
-            self.direction = block_["direction"]
-        return _types
-
-    def move_pointer(self, direction: list, new_direction):
-        """
-        给出 两个[x, y, z]坐标，返回pointer的移动过程
-        :param direction: 坐标 1
-        :param new_direction: 坐标 2
-        :return: bytes
-        """
-        _bytes = b""
-        for i, sign in enumerate(["x", "y", "z"]):
-            # print(f"<{sign}> 新-旧={new_direction[i]-direction[i]}")
-            distance = new_direction[i] - direction[i]
-            if distance == 0:
-                # print("距离是0？跳过了")
-                continue
-            _bytes += self.obtain_pointer_type(distance, sign)
-            # print(f"向 {sign} 运动了 {distance} 格子")
-        return _bytes
-
-    @classmethod
-    def obtain_pointer_type(cls, num: int, coordinate: str):
-        """
-
-        用于确定辅助玩家以某一数据类型走指定长度
-
-        -1 -> 0
-        1 -> 1
-        [128, 127] -> 2
-        [-32768, 32767] -> 3
-        [-2147483648, 2147483647] -> 4
-        :param num:
-        :param coordinate: 坐标轴种类，x y 或 z
-        :return:
-        """
-        if num == 0:
-            return
-        pointer = 0
-        condition = (num != -1,  # byte=0, pointer=1
-                     num < -1 or num > 1,  # byte=1, pointer=2
-                     num < -128 or num > 127,  # byte=2, pointer=3
-                     num < -32768 or num > 32767,  # byte=4, pointer=4
-                     )
-        for i in condition:
-            if i:
-                pointer += 1
-        pointer_type = cls.keys[coordinate][pointer]
-
-        byte_len = 2 ** (pointer - 2)
-        if byte_len >= 1:
-            num_byte = num.to_bytes(byte_len, byteorder="big", signed=True)
-            return pointer_type + num_byte
-        return pointer_type
-
-    def obtain_universal_block(self, block1):
-        """
-        给定一个方块， 返回此方块在这个bdx中的id和方块data
-        :param block1: {block_name: str,particular_value: int}
-        :return: bytes
-        """
-        block_id = b"\x07" + self.block_type.index(block1["block_name"]).to_bytes(2, byteorder="big", signed=False)
-        particular_value = block1["particular_value"].to_bytes(2, byteorder="big", signed=False)
-        block_header = block_id + particular_value
-        return block_header
-
-    def obtain_command_block(self, block1):
-        """
-        给定一个命令方块，返回命令方块各种数据
-        :param block1: {
-            "direction": [x: int, y: int, z: int]
-            "block_name": str,
-            "particular_value": int,
-            "impluse": int,  # unsigned_int32
-            "command": str,
-            "customName": str,
-            "lastOutput": str,  # 没特殊要求写个\x00就得了
-            "tickdelay": int,  # int32
-            "executeOnFirstTick": int,  # 1 bytes
-            "trackOutput": int,  # 1 bytes
-            "conditional": int,  # 1 bytes
-            "needRedstone": int  # 1 bytes
-        }
-        :return: bytes of command_block
-        """
-
-        block_id = b"\x1b" + self.block_type.index(block1["block_name"]).to_bytes(2, byteorder="big", signed=False)
-        particular_value = block1["particular_value"].to_bytes(2, byteorder="big", signed=False)
-        block_header = block_id + particular_value
-        for i in [
-            block1["impluse"].to_bytes(4, byteorder="big", signed=False),
-            bytes(block1["command"], encoding="utf-8") + b"\x00",
-            bytes(block1["customName"], encoding="utf-8") + b"\x00",
-            bytes(block1["lastOutput"], encoding="utf-8") + b"\x00",
-            block1["tickdelay"].to_bytes(4, byteorder="big", signed=True),
-            block1["executeOnFirstTick"].to_bytes(1, byteorder="big"),
-            block1["trackOutput"].to_bytes(1, byteorder="big"),
-            block1["conditional"].to_bytes(1, byteorder="big"),
-            block1["needRedstone"].to_bytes(1, byteorder="big")
-        ]:
-            block_header += i
-        return block_header
-
-
-if __name__ == '__main__':
-    block = [{"direction": [-1, -1, -1], "block_name": "concrete", "particular_value": 5},
-             {"direction": [1, 5, 1], "block_name": "stained_glass", "particular_value": 7},
-             {"direction": [2, 4, 1], "block_name": "command_block", "particular_value": 3,
-              "impluse": 0,
-              "command": "say A generator test",
-              "customName": "test",
-              "lastOutput": "",
-              "tickdelay": 24,
-              "executeOnFirstTick": 0,
-              "trackOutput": 0,
-              "conditional": 0,
-              "needRedstone": 1
-              },
-             {"direction": [3, 4, 1], "block_name": "concrete", "particular_value": 6},
-             {"direction": [-123412133, 4, 1], "block_name": "concrete", "particular_value": 7}]
-    bdx = BdxConverter("./test02.bdx", "Charlie_Ping", block)

msctspt/bugReporter.py

@@ -1,137 +0,0 @@
-# -*- coding: UTF-8 -*-
-"""提供错误报告的基本操作及方法 顺便提供版本更新、安装库等功能"""
-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：1个；语法（一级）错误：72个
-import os
-import zipfile
-
-
-def makeZip(sourceDir, outFilename, compression=8, exceptFile=None):
-    """使用compression指定的算法打包目录为zip文件\n
-    默认算法为DEFLATED(8),可用算法如下：\n
-    STORED = 0\n
-    DEFLATED = 8\n
-    BZIP2 = 12\n
-    LZMA = 14\n
-    """
-    zipf = zipfile.ZipFile(outFilename, 'w', compression)
-    pre_len = len(os.path.dirname(sourceDir))
-    for parent, dirnames, filenames in os.walk(sourceDir):
-        for filename in filenames:
-            if filename == exceptFile:
-                continue
-            print(filename)
-            pathfile = os.path.join(parent, filename)
-            arcname = pathfile[pre_len:].strip(os.path.sep)  # 相对路径
-            zipf.write(pathfile, arcname)
-
-    zipf.close()
-    del zipf, pre_len
-
-
-# 以上函数节选并修改自 正在攀登的小蜗牛 的博客：https://blog.csdn.net/qq_21127151/article/details/107503942
-
-
-class report:
-    """发送报告以及相应的任务处理"""
-
-    def __init__(self, senderName: str = 'Unknown', senderContact: str = 'None', describetion: str = ''):
-        """:param senderName 发送者名称
-        :param senderContact 发送者联系方式
-        :param describetion 问题描述"""
-        self.senderName = senderName
-        self.senderContact = senderContact
-        self.describetion = describetion
-        if not self.senderName:
-            self.senderName = 'Unknown'
-        if not self.senderContact:
-            self.senderContact = 'None'
-
-    def emailReport(self):
-        """使用E-mail方法发送当前的日志和临时文件等"""
-        import smtplib
-        from email.mime.text import MIMEText
-        from email.mime.multipart import MIMEMultipart
-        from email.header import Header
-        from nmcsup.log import log
-        log("发送错误报告")
-        import os
-        log("添加标题与正文")
-        msg = MIMEMultipart()
-        # 发送者与接收者显示名称
-        msg["From"] = Header(self.senderName, 'utf-8')
-        msg["To"] = Header("W-YI (QQ2647547478)", 'utf-8')
-        # 标题
-        msg["Subject"] = '音·创 - 来自 ' + self.senderName + ' 的错误报告'
-        # 正文
-        msg.attach(
-            MIMEText("来自" + self.senderName + "( " + self.senderContact + " )的错误描述：\n" + self.describetion,
-                     'utf-8'))
-        log("添加完毕，正在生成压缩包...")
-        makeZip("./", "Temps&Logs.zip", exceptFile="Temps&Logs.zip")
-        attafile = MIMEText(str(open("Temps&Logs.zip", 'rb').read()), "base64", 'gb2312')
-        attafile["Content-Type"] = 'application/octet-stream'
-        attafile["Content-Disposition"] = 'attachmentfilename="BugReport_from_' + self.senderName + '.zip"'
-        msg.attach(attafile)
-        log("完毕，准备发送")
-        try:
-            smtp = smtplib.SMTP()
-            smtp.connect("smtp.163.com")
-            # smtp.login("RyounDevTeam@163.com","RyounDaiYi99")
-            # SIQQKQQYCZRVIDFJ是授权密码
-            smtp.login("RyounDevTeam@163.com", "SIQQKQQYCZRVIDFJ")
-            smtp.sendmail("RyounDevTeam@163.com", ["RyounDevTeam@163.com", ], msg.as_string())
-            log("错误汇报邮件已发送")
-        except smtplib.SMTPException as e:
-            log("错误汇报邮件发送失败：\n" + str(e))
-        log("清空内存和临时文件")
-        del msg, attafile
-        os.remove("./Temps&Logs.zip")
-
-
-class version:
-    libraries = (
-        'mido', 'amulet', 'amulet-core', 'amulet-nbt', 'piano_transcription_inference', 'pypinyin',
-        'pyinstaller','py7zr','websockets', 'torch'
-        )
-    """当前所需库，有一些是开发用的，用户不需要安装"""
-
-    version = ('0.1.5.1', 'Delta',)
-    """当前版本"""
-
-    def __init__(self) -> None:
-
-        self.libraries = version.libraries
-        """当前所需库，有一些是开发用的，用户不需要安装"""
-
-        self.version = version.version
-        """当前版本"""
-        
-
-    def installLibraries(self,index:str = 'https://pypi.tuna.tsinghua.edu.cn/simple'):
-        """安装全部开发用库"""
-        from sys import platform
-        import os
-        if platform == 'win32':
-            import shutil
-            try:
-                shutil.rmtree(os.getenv('APPDATA') + '\\Musicreater\\')
-            except FileNotFoundError:
-                pass
-            for i in self.libraries:
-                print("安装库：" + i)
-                os.system(f"python -m pip install {i} -i {index}")
-        elif platform == 'linux':
-            os.system("sudo apt-get install python3-pip")
-            os.system("sudo apt-get install python3-tk")
-            os.system("sudo apt-get install python3-tkinter")
-            for i in self.libraries:
-                print("安装库：" + i)
-                os.system(f"sudo python3 -m pip install {i} -i {index}")
-    
-
-    def __call__(self):
-        '''直接安装库，顺便返回一下当前版本'''
-        self.installLibraries()
-        return self.version

msctspt/funcOpera.py

@@ -1,396 +0,0 @@
-# -*- coding: utf-8 -*-
-"""音·创 的函数操作和一些其他功能"""
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：91个
-
-
-from nmcsup.log import log
-
-
-def delPart(Data, starter, ender, includeStart: bool = True, includend: bool = True):
-    """删除序列从starter物件到ender物件之间的部分\n
-    includeStart与inclodend分别控制此函数是否包括starter和ender物件所在部分，默认为真\n
-    starter与ender若为None则默认从首或尾开始"""
-    try:
-        if starter is None:
-            includeStart = True
-            starter = Data[0]
-        if ender is None:
-            includend = True
-            ender = Data[len(Data) - 1]
-        if includend:
-            if includeStart:
-                return Data[Data.index(starter):len(Data) - Data[len(Data)::-1].index(ender)]
-            else:
-                return Data[Data.index(starter) + 1:len(Data) - Data[len(Data)::-1].index(ender)]
-        else:
-            if includeStart:
-                return Data[Data.index(starter):len(Data) - Data[len(Data)::-1].index(ender) - 1]
-            else:
-                return Data[Data.index(starter) + 1:len(Data) - Data[len(Data)::-1].index(ender) - 1]
-    except:
-        return 0
-
-
-def keepart(Data, starter, ender, includeStart: bool = True, includend: bool = True):
-    """保留序列从starter物件到ender物件之间的部分\n
-    includeStart与inclodend分别控制此函数是否包括starter和ender物件所在部分，默认为真\n
-    starter与ender若为None则默认从首或尾开始"""
-    try:
-        if starter is None:
-            includeStart = True
-            starter = Data[0]
-        if ender is None:
-            includend = True
-            ender = Data[len(Data) - 1]
-        if includend:
-            if includeStart:
-                return Data[Data.index(starter):Data.index(ender) + 1]
-            else:
-                return Data[Data.index(starter) + 1:Data.index(ender) + 1]
-        else:
-            if includeStart:
-                return Data[Data.index(starter):Data.index(ender)]
-            else:
-                return Data[Data.index(starter) + 1:Data.index(ender)]
-    except:
-        return 0
-
-
-def lenFunction(fun) -> int:
-    """取得函数指令部分长度，即忽略#开头的注释"""
-    try:
-        f = 0
-        for i in fun:
-            if i.replace(" ", '')[0] == '#':
-                f += 1
-        return len(fun) - f
-    except:
-        return -1
-
-
-def funSplit(bigFile, maxCmdLen: int = 10000):
-    """分割bigFile大的函数文件，bigFile需要读入文件流\n
-    返回的部分，每行指令皆带有行尾换行符\\n\n
-    返回-1为大小低于maxCmdLen最长函数指令长度"""
-    bigFile = bigFile.readlines()
-    if lenFunction(bigFile) < maxCmdLen:
-        return -1
-    part = []
-    parts = []
-    h = 0
-    for i in bigFile:
-        if i.replace(" ", '')[0] == '#':
-            part.append(i + '\n')
-        else:
-            part.append(i + '\n')
-            h += 1
-        if h >= 10000:
-            parts.append(part)
-            part = []
-            h = 0
-    return parts
-
-
-# 注意！播放器应该为个人独立播放器，此处bug需要修改
-def makeFuncFiles(musicset, path='./'):
-    """在指定目录下生成函数文件"""
-    from nmcsup.trans import Note2Cmd
-    commands = []
-    starts = []
-    log("=========================正在在此处生成文件:" + path)
-    maxlen = -1
-    for i in range(len(musicset['musics'])):
-        log('写入第' + str(i) + '个数据')
-        commands.append("scoreboard players add @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\"] " +
-                        musicset['musics'][i]['set']['ScoreboardName'] + " 1\n")
-        commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                        musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset'][
-                            'PlayerSelect'] + " title " + musicset['mainset']['MusicTitle'] + "\n")
-        commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                        musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset'][
-                            'PlayerSelect'] + " subtitle 本函数乐曲由§b§l凌云§r§3函数音乐创建§r生成\n")
-        if len(musicset['musics'][i]['notes']) > maxlen:
-            maxlen = len(musicset['musics'][i]['notes'])
-        starts.append("scoreboard objectives add " + musicset['musics'][i]['set']['ScoreboardName'] + " dummy\n")
-        starts.append("summon armor_stand " + musicset['musics'][i]['set']['EntityName'] + '\n')
-        with open(path + musicset['mainset']['MusicTitle'] + '_Part' + str(i) + '.mcfunction', 'w',
-                  encoding='UTF-8') as f:
-            f.writelines(Note2Cmd(musicset['musics'][i]['notes'], musicset['musics'][i]['set']['ScoreboardName'],
-                                  musicset['musics'][i]['set']['Instrument'], musicset['mainset']['PlayerSelect'],
-                                  True))
-    if musicset['mainset']['IsRepeat']:
-        log("增加重复语句")
-        for i in range(len(musicset['musics'])):
-            commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                            musicset['musics'][i]['set']['ScoreboardName'] + "=" + str(
-                (maxlen + 2) * 10) + "}] ~~~ scoreboard players set @e[name=\"" + musicset['musics'][i]['set'][
-                                'EntityName'] + "\"] " + musicset['musics'][i]['set']['ScoreboardName'] + " -1\n")
-    log("增加版权语句")
-    commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    starts.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    log("写入支持文件")
-    with open(path + musicset['mainset']['MusicTitle'] + '_Support.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(commands)
-    log("写入开始文件")
-    with open(path + 'Start_' + musicset['mainset']['MusicTitle'] + '.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(starts)
-    del commands, starts, maxlen
-    log("完成============================")
-
-
-def makeFunDir(musicset, path='./'):
-    """在指定目录下生成函数包文件夹"""
-    import os
-    import uuid
-    log("=============================生成函数包文件夹")
-    # note,packname="Ryoun",FileName="Music",EntityName_='music_support',ScoreboardName_='music_support',
-    # MusicTitle_='Noname',PlayerSelect_='',Repeat_=False,Instrument_='harp'
-    try:
-        os.makedirs(path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-        log("已创建目录" + path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-    except FileExistsError:
-        log("目录已有无需创建")
-        pass
-    # 判断文件皆存在
-    if not (os.path.exists(
-            path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json") and os.path.exists(
-        path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/manifest.json")):
-        log("创建manifest.json以及world_behavior_packs.json")
-        behaviorUuid = uuid.uuid4()
-        with open(path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json", "w") as f:
-            f.write("[\n  {\"pack_id\": \"" + str(behaviorUuid) + "\",\n  \"version\": [ 0, 0, 1 ]}\n]")
-        p = path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset']['PackName'] + \
-            "/manifest.json"
-        with open(p, "w") as f:
-            f.write("{\n  \"format_version\": 1,\n  \"header\": {\n    \"description\": \"" + musicset['mainset'][
-                'PackName'] + " Pack : behavior pack\",\n    \"version\": [ 0, 0, 1 ],\n    \"name\": \"" +
-                    musicset['mainset']['PackName'] + "Pack\",\n    \"uuid\": \"" + str(
-                behaviorUuid) + "\"\n  },\n  \"modules\": [\n    {\n      \"description\": \"" + musicset['mainset'][
-                        'PackName'] + " Pack : behavior pack\",\n      \"type\": \"data\",\n      \"version\":"
-                                      " [ 0, 0, 1 ],\n      \"uuid\": \"" + str(
-                uuid.uuid4()) + "\"\n    }\n  ]\n}")
-    makeFuncFiles(musicset, path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-        'PackName'] + "/functions/")
-    log("完成============================")
-
-
-def makeNewFuncFiles(musicset, path='./'):
-    """在指定目录下生成函数文件"""
-    from msctspt.transfer import newList_conversion_SinglePlayer
-    commands = []
-    starts = []
-    starts.__len__()
-    starts.append("scoreboard objectives add " + musicset['musics'][0]['set']['ScoreboardName'] + " dummy\n")
-    starts.append("summon armor_stand " + musicset['musics'][0]['set']['EntityName'] + '\n')
-    starts.append("scoreboard objectives setdisplay sidebar " + musicset['musics'][0]['set']['ScoreboardName'] + '\n')
-    starts.append("scoreboard players set @e[type=armor_stand, name=\"" + musicset['musics'][0]['set']['EntityName'] +
-                  "\"] " + musicset['musics'][0]['set']['ScoreboardName'] + " 0" + '\n')
-    log("=========================正在在此处生成文件:" + path)
-    commands.append("scoreboard players add @e[name=\"" + musicset['musics'][0]['set']['EntityName'] + "\"] " +
-                    musicset['musics'][0]['set']['ScoreboardName'] + " 1\n")
-    maxlen = -1
-    for i in range(len(musicset['musics'])):
-        log('写入第' + str(i) + '个数据')
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " title " + musicset['mainset']['MusicTitle'] + "\n")
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " subtitle 本函数乐曲由§b§l凌云§r§3函数音乐创建§r生成\n")
-        if len(musicset['musics'][i]['notes']) > maxlen:
-            maxlen = len(musicset['musics'][i]['notes'])
-        with open(path + musicset['mainset']['MusicTitle'] + '_Part' + str(i) + '.mcfunction', 'w',
-                  encoding='UTF-8') as f:
-            f.writelines(newList_conversion_SinglePlayer(musicset['musics'][i]['notes'],
-                                                         musicset['musics'][i]['set']['ScoreboardName']))
-    if musicset['mainset']['IsRepeat']:
-        log("增加重复语句")
-        for i in range(len(musicset['musics'])):
-            commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                            musicset['musics'][i]['set']['ScoreboardName'] + "=" + str(
-                (maxlen + 2) * 10) + "}] ~~~ scoreboard players set @e[name=\"" + musicset['musics'][i]['set'][
-                                'EntityName'] + "\"] " + musicset['musics'][i]['set']['ScoreboardName'] + " -1\n")
-    log("增加版权语句")
-    commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    starts.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    log("写入支持文件")
-    with open(path + musicset['mainset']['MusicTitle'] + '_Support.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(commands)
-    log("写入开始文件")
-    with open(path + 'Start_' + musicset['mainset']['MusicTitle'] + '.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(starts)
-    del commands, starts, maxlen
-    log("完成============================")
-
-
-def makeNewFunDir(musicset, path='./'):
-    """在指定目录下生成函数包文件夹"""
-    import os
-    import uuid
-    log("=============================生成函数包文件夹")
-    # note,packname="Ryoun",FileName="Music",EntityName_='music_support',ScoreboardName_='music_support',
-    # MusicTitle_='Noname',PlayerSelect_='',Repeat_=False,Instrument_='harp'
-    try:
-        os.makedirs(path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-        log("已创建目录" + path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-    except FileExistsError:
-        log("目录已有无需创建")
-        pass
-    # 判断文件皆存在
-    if not (os.path.exists(
-            path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json") and os.path.exists(
-        path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/manifest.json")):
-        log("创建manifest.json以及world_behavior_packs.json")
-        behaviorUuid = uuid.uuid4()
-        with open(path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json", "w") as f:
-            f.write("[\n  {\"pack_id\": \"" + str(behaviorUuid) + "\",\n  \"version\": [ 0, 0, 1 ]}\n]")
-        p = path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset']['PackName'] + \
-            "/manifest.json"
-        with open(p, "w") as f:
-            f.write("{\n  \"format_version\": 1,\n  \"header\": {\n    \"description\": \"" + musicset['mainset'][
-                'PackName'] + " Pack : behavior pack\",\n    \"version\": [ 0, 0, 1 ],\n    \"name\": \"" +
-                    musicset['mainset']['PackName'] + "Pack\",\n    \"uuid\": \"" + str(
-                behaviorUuid) + "\"\n  },\n  \"modules\": [\n    {\n      \"description\": \"" + musicset['mainset'][
-                        'PackName'] + " Pack : behavior pack\",\n      \"type\": \"data\",\n      \"version\":"
-                                      " [ 0, 0, 1 ],\n      \"uuid\": \"" + str(
-                uuid.uuid4()) + "\"\n    }\n  ]\n}")
-    makeNewFuncFiles(musicset, path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-        'PackName'] + "/functions/")
-    log("完成============================")
-
-
-def makeClassFuncFiles(musicset, path='./'):
-    """在指定目录下生成函数文件"""
-    from msctspt.transfer import classList_conversion_SinglePlayer
-    commands = []
-    starts = []
-    starts.__len__()
-    starts.append("scoreboard objectives add " + musicset['musics'][0]['set']['ScoreboardName'] + " dummy\n")
-    starts.append("summon armor_stand " + musicset['musics'][0]['set']['EntityName'] + '\n')
-    starts.append("scoreboard objectives setdisplay sidebar " + musicset['musics'][0]['set']['ScoreboardName'] + '\n')
-    starts.append("scoreboard players set @e[type=armor_stand, name=\"" + musicset['musics'][0]['set']['EntityName'] +
-                  "\"] " + musicset['musics'][0]['set']['ScoreboardName'] + " 0" + '\n')
-    log("=========================正在在此处生成文件:" + path)
-    commands.append("scoreboard players add @e[name=\"" + musicset['musics'][0]['set']['EntityName'] + "\"] " +
-                    musicset['musics'][0]['set']['ScoreboardName'] + " 1\n")
-    maxlen = -1
-    for i in range(len(musicset['musics'])):
-        log('写入第' + str(i) + '个数据')
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " title " + musicset['mainset']['MusicTitle'] + "\n")
-        # commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-        #                 musicset['musics'][i]['set']['ScoreboardName'] + "=1..10}] ~~~ title @a" + musicset['mainset']
-        #                 [
-        #                     'PlayerSelect'] + " subtitle 本函数乐曲由§b§l凌云§r§3函数音乐创建§r生成\n")
-        if len(musicset['musics'][i]['notes']) > maxlen:
-            maxlen = len(musicset['musics'][i]['notes'])
-        with open(path + musicset['mainset']['MusicTitle'] + '_Part' + str(i) + '.mcfunction', 'w',
-                  encoding='UTF-8') as f:
-            f.writelines(classList_conversion_SinglePlayer(musicset['musics'][i]['notes'],
-                                                           musicset['musics'][i]['set']['ScoreboardName'],
-                                                           musicset['musics'][i]['set']['Instrument'],
-                                                           musicset['mainset']['PlayerSelect'],
-                                                           True))
-    if musicset['mainset']['IsRepeat']:
-        log("增加重复语句")
-        for i in range(len(musicset['musics'])):
-            commands.append("execute @e[name=\"" + musicset['musics'][i]['set']['EntityName'] + "\",scores={" +
-                            musicset['musics'][i]['set']['ScoreboardName'] + "=" + str(
-                (maxlen + 2) * 10) + "}] ~~~ scoreboard players set @e[name=\"" + musicset['musics'][i]['set'][
-                                'EntityName'] + "\"] " + musicset['musics'][i]['set']['ScoreboardName'] + " -1\n")
-    log("增加版权语句")
-    commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    starts.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿），bgArray（诸葛亮与八卦阵）\n")
-    log("写入支持文件")
-    with open(path + musicset['mainset']['MusicTitle'] + '_Support.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(commands)
-    log("写入开始文件")
-    with open(path + 'Start_' + musicset['mainset']['MusicTitle'] + '.mcfunction', 'w', encoding='UTF-8') as f:
-        f.writelines(starts)
-    del commands, starts, maxlen
-    log("完成============================")
-
-
-def makeClassFunDir(musicset, path='./'):
-    """在指定目录下生成函数包文件夹"""
-    import os
-    import uuid
-    log("=============================生成函数包文件夹")
-    # note,packname="Ryoun",FileName="Music",EntityName_='music_support',ScoreboardName_='music_support',
-    # MusicTitle_='Noname',PlayerSelect_='',Repeat_=False,Instrument_='harp'
-    try:
-        os.makedirs(path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-        log("已创建目录" + path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/functions")
-    except FileExistsError:
-        log("目录已有无需创建")
-        pass
-    # 判断文件皆存在
-    if not (os.path.exists(
-            path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json") and os.path.exists(
-        path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-            'PackName'] + "/manifest.json")):
-        log("创建manifest.json以及world_behavior_packs.json")
-        behaviorUuid = uuid.uuid4()
-        with open(path + musicset['mainset']['PackName'] + "Pack/world_behavior_packs.json", "w") as f:
-            f.write("[\n  {\"pack_id\": \"" + str(behaviorUuid) + "\",\n  \"version\": [ 0, 0, 1 ]}\n]")
-        p = path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset']['PackName'] + \
-            "/manifest.json"
-        with open(p, "w") as f:
-            f.write("{\n  \"format_version\": 1,\n  \"header\": {\n    \"description\": \"" + musicset['mainset'][
-                'PackName'] + " Pack : behavior pack\",\n    \"version\": [ 0, 0, 1 ],\n    \"name\": \"" +
-                    musicset['mainset']['PackName'] + "Pack\",\n    \"uuid\": \"" + str(
-                behaviorUuid) + "\"\n  },\n  \"modules\": [\n    {\n      \"description\": \"" + musicset['mainset'][
-                        'PackName'] + " Pack : behavior pack\",\n      \"type\": \"data\",\n      \"version\":"
-                                      " [ 0, 0, 1 ],\n      \"uuid\": \"" + str(
-                uuid.uuid4()) + "\"\n    }\n  ]\n}")
-    makeClassFuncFiles(musicset, path + musicset['mainset']['PackName'] + "Pack/behavior_packs/" + musicset['mainset'][
-        'PackName'] + "/functions/")
-    log("完成============================")
-
-
-"""
-这里是往事，用于记载一些用不到的功能
-
-#存在于 Musicreater.py 播放(试听)音乐
-def PlayNote(Notes, t=480):  # Notes是音符列表，t是一拍占有的毫秒数
-    tkinter.messagebox.showinfo(title='提示！', message="播放发音不一定标准\n说不定还会坏音响/(ㄒoㄒ)/~~qwq\n请注意。")
-    import winsound
-    import time
-    from nmcsup.trans import mcnote2freq
-    Notes = mcnote2freq(Notes)
-    for frequency, duration in Notes:
-        log("播放："+str([int(frequency), int(duration*t)]))
-        if int(frequency) != 0:
-            winsound.Beep(int(frequency), int(duration*t))
-        elif int(frequency) == 0:
-            time.sleep(duration*t/1000)
-
-#同上，执行播放命令
-def PlayOne():
-    log("试听")
-    tkinter.messagebox.showwarning(title="警告⚠", message="试听音质可能引起您的不适，更可能引起您的扬声器的不适，请酌情播放。")
-    global NowMusic
-    PlayNote(dataset[0]['musics'][NowMusic]['notes'])
-
-
-
-#同上，是早期 MinecraftMusicFunctionMaker.py (函数音创)的代码转移至音·创时的注解
-n2c(dataset[0]['musics'][i]['notes'],EntityName=dataset[0]['musics'][i]['set']['EntityName'],ScoreboardName=dataset[0]['
-musics'][i]['set']['ScoreboardName'],PlayerSelect=dataset[0]['mainset']['PlayerSelect'],Instrument=dataset[0]['musics']
-i]['set']["Instrument"])
-
-
-"""

msctspt/settings.py

@@ -1,18 +0,0 @@
-# -*- coding:utf-8 -*-
-
-
-
-
-settings = {
-    'language' : 'zh-CN',
-    'theme' : {
-        '' : '',
-    },
-}
-
-class msctSetting:
-    def __init__(self,**settings) -> None:
-        pass
-        
-    def __call__(self, **kwds):
-        pass

msctspt/threadOpera.py

@@ -1,27 +0,0 @@
-
-
-
-import threading
-
-
-class NewThread(threading.Thread):
-    '''新建一个进程来运行函数，函数运行完毕后可以使用.getResult方法获取其返回值'''
-    def __init__(self, func, args=()):
-        super(NewThread, self).__init__()
-        self.func = func
-        self.args = args
-    def run(self):
-        self.result = self.func(*self.args)
-    def getResult(self):
-        threading.Thread.join(self)  # 等待线程执行完毕
-        try:
-            return self.result
-        except Exception:
-            return None
-
-#
-# ————————————————
-# 版权声明：上面的类NewThread修改自CSDN博主「星火燎愿」的原创文章中的内容，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
-# 原文链接：https://blog.csdn.net/xpt211314/article/details/109543014
-# ————————————————
-#

msctspt/transfer.py

@@ -1,541 +0,0 @@
-"""音·创 的转换工具库"""
-
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：4个--未解决1个；语法（一级）错误：302个
-
-
-# 可序列化对象，即可迭代对象
-from typing import Iterable
-
-import amulet
-
-from amulet.api.block import Block
-from amulet.utils.world_utils import block_coords_to_chunk_coords as bc2cc
-from amulet_nbt import TAG_String as ts
-from nmcsup.log import log
-
-
-def hans2pinyin(hans, style=3):
-    """将汉字字符串转化为拼音字符串"""
-    from pypinyin import lazy_pinyin
-    result = lazy_pinyin(hans=hans, style=style)
-    final = ''
-    for i in result:
-        final += i
-    return final
-
-
-def classList_conversion_SinglePlayer(List: list, ScoreboardName: str, Instrument: str, playerSelection: str = '',
-                                      isProsess: bool = False) -> list:
-    from bgArrayLib.compute import round_up
-    from bgArrayLib.pitchStrConstant import pitch
-    commands = []
-    length = len(List)
-    j = 1
-    print(List)
-    for k in range(len(List)):
-        i = List[k][0]
-        print(i)
-        print(type(i))
-        try:
-            if i.instrument > 119:
-                pass
-            else:
-                commands.append(
-                    f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                    f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~{127 - i.velocity} "
-                    f"~ playsound {Instrument} @s ~ ~ ~ 1000 {pitch.get(str(i.pitch))} 1000\n")
-                if isProsess:
-                    commands.append(
-                        f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                        f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~ ~ "
-                        f"title @s actionbar §e▶  播放中：  §a{j}/{length}  ||  {int(j / length * 1000) / 10}\n")
-                    j += 1
-        except:
-            pass
-            # a += List[i][1]
-    # commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    print(commands)
-    return commands
-
-
-def newList_conversion_SinglePlayer(List: list, ScoreboardName: str, playerSelection: str = '',
-                                    isProsess: bool = False) -> list:
-    from bgArrayLib.compute import round_up
-    commands = []
-    length = len(List)
-    j = 1
-    print(List)
-    for k in range(len(List)):
-        i = List[k][0]
-        print(i)
-        print(type(i))
-        try:
-            if i.instrument > 119:
-                pass
-            else:
-                commands.append(
-                    f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                    f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~{127 - i.velocity} "
-                    f"~ playsound {i.instrument}{i.CD}.{i.pitch} @s ~ ~ ~ 1000 1.0 1000\n")
-                if isProsess:
-                    commands.append(
-                        f"execute @a{playerSelection} ~ ~ ~ execute @s[scores={{{ScoreboardName}="
-                        f"{str(round_up(i.time_position)).replace('.0', '')}}}] ~ ~ ~ "
-                        f"title @s actionbar §e▶  播放中：  §a{j}/{length}  ||  {int(j / length * 1000) / 10}\n")
-                    j += 1
-        except:
-            pass
-            # a += List[i][1]
-    # commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    print(commands)
-    return commands
-
-
-def classList_conversion(List: list, ScoreboardName: str, isProsess: bool = False) -> list:
-    from bgArrayLib.compute import round_up
-    commands = []
-    length = len(List)
-    j = 1
-    print(List)
-    for k in range(len(List)):
-        i = List[k][0]
-        print(i)
-        print(type(i))
-        try:
-            if i.instrument > 119:
-                pass
-            else:
-                commands.append("execute @e[scores={" +
-                                ScoreboardName + "=" + str(round_up(i.time_position)).replace(".0", "") + "}] ~ ~" +
-                                str(127 - i.velocity) +
-                                " ~ playsound " +
-                                str(i.instrument) +
-                                str(i.CD) + "." +
-                                str(i.pitch)
-                                + " @a ~ ~ ~ 1000 1.0 1000\n")
-                if isProsess:
-                    commands.append("execute @a"" ~ ~ ~ execute @s[scores={" + ScoreboardName + "=" +
-                                    str(round_up(i.time_position)).replace(".0", "") +
-                                    "}] ~ ~ ~ title @s actionbar §e▶  播放中：  §a" +
-                                    str(j) + "/" + str(length) + "  ||  " + str(int(j / length * 1000) / 10) + "\n")
-                    j += 1
-        except AttributeError:
-            pass
-            # a += List[i][1]
-    # commands.append("\n\n# 凌云我的世界开发团队 x 凌云软件开发团队  : W-YI（金羿）\n")
-    print(commands)
-    return commands
-
-
-def formCmdBlock(direction: Iterable, command: str, particularValue: int, impluse: int = 0, condition: bool = False,
-                 needRedstone: bool = True, tickDelay: int = 0, customName: str = '', lastOutput: str = '',
-                 executeOnFirstTick: bool = False, trackOutput: bool = True):
-    """
-    使用指定项目返回指定的指令方块格式字典
-    :param direction: `list[x: int, y: int, z: int]`
-        方块位置
-    :param command: `str`
-        指令
-    :param particularValue:
-        方块特殊值，即朝向
-            :0	下	无条件
-            :1	上	无条件
-            :2	z轴负方向	无条件
-            :3	z轴正方向	无条件
-            :4	x轴负方向	无条件
-            :5	x轴正方向	无条件
-            :6	下	无条件
-            :7	下	无条件
-
-            :8	下	有条件
-            :9	上	有条件
-            :10	z轴负方向	有条件
-            :11	z轴正方向	有条件
-            :12	x轴负方向	有条件
-            :13	x轴正方向	有条件
-            :14	下	有条件
-            :14	下	有条件
-        注意！此处特殊值中的条件会被下面condition参数覆写
-    :param impluse: `int 0|1|2`
-        方块类型
-            0脉冲 1循环 2连锁
-    :param condition: `bool`
-        是否有条件
-    :param needRedstone: `bool`
-        是否需要红石
-    :param tickDelay: `int`
-        执行延时
-    :param customName: `str`
-        悬浮字
-    :param lastOutput: `str`
-        上次输出字符串，注意此处需要留空
-    :param executeOnFirstTick: `bool`
-        执行第一个已选项(循环指令方块是否激活后立即执行，若为False，则从激活时起延迟后第一次执行)
-    :param trackOutput: `bool`
-        是否输出
-
-    :return: 指令方块字典结构，如下
-    """
-    '''
-    :param block: {
-        "direction": [x: int, y: int, z: int]  #方块位置
-        "block_name": str,  #方块名称（无需指定，默认为command_block）
-        "particular_value": int,  #方块特殊值
-        "impluse": int,  #方块类型0脉冲 1循环 2连锁 unsigned_int32
-        "command": str,  #指令
-        "customName": str,  #悬浮字
-        "lastOutput": str,  #上次输出
-        "tickdelay": int,  #方块延时 int32
-        "executeOnFirstTick": int,  #执行第一个选项 1 bytes
-        "trackOutput": int,  #是否输出 1 bytes
-        "conditional": int,  #是否有条件 1 bytes
-        "needRedstone": int  #是否需要红石 1 bytes
-    }
-    '''
-    return {"direction": direction,
-            "block_name": "command_block",
-            "particular_value": particularValue,
-            "impluse": impluse,
-            "command": command,
-            "customName": customName,
-            "lastOutput": lastOutput,
-            "tickdelay": tickDelay,
-            "executeOnFirstTick": executeOnFirstTick,
-            "trackOutput": trackOutput,
-            "conditional": condition,
-            "needRedstone": needRedstone
-            }
-
-
-def note2bdx(filePath: str, dire: list, Notes: list, ScoreboardName: str, Instrument: str,
-             PlayerSelect: str = '', isProsess: bool = False, height: int = 200):
-    """使用方法同Note2Cmd
-    :param 参数说明：
-        filePath: 生成.bdx文件的位置
-        dire: 指令方块在地图中生成的起始位置（相对位置）
-        Notes: 以 list[ list[ float我的世界playsound指令音调 , float延续时常（单位s） ] ] 格式存储的音符列表
-                例如Musicreater.py的(dataset[0]['musics'][NowMusic]['notes'])
-        ScoreboardName: 用于执行的计分板名称
-        Instrument: 播放的乐器
-        PlayerSelect: 执行的玩家选择器
-        isProsess: 是否显示进度条（会很卡）
-        height: 生成结构的最高高度
-    :return 返回一个BdxConverter类，同时在指定位置生成.bdx文件"""
-
-    # from msctspt.transfer import formCmdBlock
-    from nmcsup.trans import Note2Cmd
-    from msctspt.bdxOpera_CP import BdxConverter
-    cmd = Note2Cmd(Notes, ScoreboardName, Instrument, PlayerSelect, isProsess)
-    cdl = []
-    # 此处是处理一下，防止有注释
-    for i in cmd:
-        # e = True
-        try:
-            if (i[:i.index('#')].replace(' ', '') != '\n') and (i[:i.index('#')].replace(' ', '') != ''):
-                cdl.append(i[:i.index('#')])
-            # e = False
-        except:  # ValueError
-            cdl.append(i)
-        # finally:
-        #     if e is True:
-        #         cdl.append(i)
-    i = 0
-    down = False
-    blocks = [formCmdBlock(dire, cdl.pop(0), 1, 1)]
-    dire[1] += 1
-    for j in cdl:
-        if dire[1] + i > height:
-            dire[0] += 1
-            i = 0
-            down = not down
-        if dire[1] + i == height:
-            blocks.append(formCmdBlock([dire[0], dire[1] + i, dire[2]], j, 5, 2, False, False))
-        else:
-            if down:
-                blocks.append(formCmdBlock([dire[0], dire[1] + i, dire[2]], j, 0, 2, False, False))
-            else:
-                blocks.append(formCmdBlock([dire[0], dire[1] + i, dire[2]], j, 1, 2, False, False))
-        i += 1
-    del i, cdl, down, cmd
-    return BdxConverter(filePath, 'Build by RyounMusicreater', blocks)
-
-
-def music2BDX(filePath: str, direction: Iterable, music: dict, isProsess: bool = False, height: int = 200,
-              isSquare: bool = False):
-    """使用方法同Note2Cmd
-    :param 参数说明：
-        filePath: 生成.bdx文件的位置
-        dire: 指令方块在地图中生成的起始位置（相对位置）
-        music: 详见 Musicreater.py - dataset[0]
-        isProsess: 是否显示进度条（会很卡）
-        height: 生成结构的最高高度
-        isSquare: 生成的结构是否需要遵循生成正方形原则
-    :return 返回一个BdxConverter类，同时在指定位置生成.bdx文件"""
-    from msctspt.bdxOpera_CP import BdxConverter
-
-    blocks = []
-    '''需要放置的方块'''
-    baseDire = direction
-
-    direction = list(direction)
-
-    for track in music['musics']:
-        cmdList = classList_conversion_SinglePlayer(track['notes'], track['set']['ScoreboardName'],
-                                                    music['mainset']['PlayerSelect'], isProsess)
-        if len(cmdList) == 0:
-            continue
-        elif cmdList is []:
-            continue
-        dire = direction
-        down = False
-        '''当前是否为向下的阶段？'''
-        # 开头的指令方块
-        blocks.append(formCmdBlock(dire,
-                                   f"scoreboard players add @a{music['mainset']['PlayerSelect']} "
-                                   f"{track['set']['ScoreboardName']} 1",
-                                   1, 1))
-        dire[1] += 1
-        blocks.append(formCmdBlock(dire, cmdList.pop(0), 2, needRedstone=False))
-        dire[1] += 1
-        # :0	下	无条件
-        # :1	上	无条件
-        # :2	z轴负方向	无条件
-        # :3	z轴正方向	无条件
-        # :4	x轴负方向	无条件
-        # :5	x轴正方向	无条件
-        for cmd in cmdList:
-            blocks.append(formCmdBlock(dire, cmd, 5 if (down is False and dire[1] == height + direction[1]) or (
-                    down and dire[1] == direction + 1) else 0 if down else 1, 2, needRedstone=False))
-
-            if down:
-                if dire[1] > direction[1] + 1:
-                    dire[1] -= 1
-            else:
-                if dire[1] < height + direction[1]:
-                    dire[1] += 1
-
-            if (down is False and dire[1] == height + direction[1]) or (down and dire[1] == direction + 1):
-                down = not down
-                dire[0] += 1
-        direction[2] += 2
-
-    return BdxConverter(filePath, 'Build by Ryoun Musicreater', blocks)
-
-
-def note2webs(Notes: list, Instrument: str, speed: float = 5.0, PlayerSelect: str = '', isProsess: bool = False):
-    """传入音符，在oaclhost:8080上建立websocket服务器以供我的世界connect/wssever指令连接
-    :param 参数说明：
-        Notes: 以 list[ list[ float我的世界playsound指令音调 , float延续时常（单位s） ] ] 格式存储的音符列表
-        例如Musicreater.py的(dataset[0]['musics'][NowMusic]['notes'])
-        Instrument: 播放的乐器
-        speed: 用于控制播放速度，数值越大，播放速度越快，相当于把一秒变为几拍
-        PlayerSelect: 执行的玩家选择器
-        isProsess: 是否显示进度条
-    :return None"""
-
-    import time
-    import fcwslib
-    # import asyncio
-    from nmcsup.log import log
-    from nmcsup.vers import VER
-
-    async def run_server(websocket):  # , path
-        log('服务器连接创建')
-        await fcwslib.tellraw(websocket, '已连接服务器——音·创' + VER[1] + VER[0] + ' 作者：金羿(W-YI)')
-        length = len(Notes)
-        j = 1
-        for i in range(len(Notes)):
-            await fcwslib.send_command(websocket,
-                                       f'execute @a{PlayerSelect} ~ ~ ~ playsound {Instrument} @s ~ ~ ~ 1000 '
-                                       f'{Notes[i][0]} 1000')
-            if isProsess:
-                await fcwslib.send_command(websocket,
-                                           'execute @a' + PlayerSelect + ' ~ ~ ~ title @s actionbar §e▶  播放中：  §a' +
-                                           str(
-                                               j) + '/' + str(length) + '  ||  ' + str(int(j / length * 1000) / 10))
-                j += 1
-            time.sleep(Notes[i][1] / speed)
-
-    fcwslib.run_server(run_server)
-
-
-def note2RSworld(world: str, startpos: list, notes: list, instrument: str, speed: float = 2.5,
-                 posadder: Iterable = (1, 0, 0), baseblock: str = 'stone'):  # -> bool
-    """传入音符，生成以音符盒存储的红石音乐
-    :param 参数说明：
-        world: 地图文件的路径
-        startpos: list[int,int,int] 开始生成的坐标
-        notes: list[list[float,float]] 以 list[ list[ float我的世界playsound指令音调 , float延续时常（单位s） ] ]
-        格式存储的音符列表 例如Musicreater.py的dataset[0]['musics'][NowMusic]['notes']
-        instrument: 播放的乐器
-        speed: 一拍占多少个中继器延迟(红石刻/rt)
-        posadder: list[int,int,int] 坐标增加规律，即红石的延长时按照此增加规律增加坐标
-        baseblock: 在中继器下垫着啥方块呢~
-    :return 是否生成成功
-    """
-
-    from msctspt.values import height2note, instuments
-
-    def formNoteBlock(note: int, instrument1: str = 'note.harp', powered: bool = False):
-        """生成音符盒方块
-        :param powered:
-        :param instrument1:
-        :param note: 0~24
-        :return Block()"""
-        if powered:
-            powered = 'true'
-        else:
-            powered = 'false'
-        return Block('universal_minecraft', 'notebooks',
-                     {"instrument": ts(instrument1.replace("note.", '')), 'note': ts(str(note)),
-                      'powered': ts(powered)})
-
-    def formRepeater(delay: int, facing: str, locked: bool = False, powered: bool = False):
-        """生成中继器方块
-        :param powered:
-        :param locked:
-        :param facing:
-        :param delay: 1~4
-        :return Block()"""
-        if powered:
-            powered = 'true'
-        else:
-            powered = 'false'
-        if locked:
-            locked = 'true'
-        else:
-            locked = 'false'
-        return Block('universal_minecraft', 'repeater',
-                     {"delay": ts(str(delay)), 'facing': ts(facing), 'locked': ts(locked), 'powered': ts(powered)})
-
-    level = amulet.load_level(world)
-
-    def setblock(block: Block, pos: list):
-        """pos : list[int,int,int]"""
-        cx, cz = bc2cc(pos[0], pos[2])
-        chunk = level.get_chunk(cx, cz, "minecraft:overworld")
-        offset_x, offset_z = pos[0] - 16 * cx, pos[2] - 16 * cz
-        chunk.blocks[offset_x, pos[1], offset_z] = level.block_palette.get_add_block(block)
-        chunk.changed = True
-
-    # 1拍 x 2.5 rt
-    def placeNoteBlock():
-        for i in notes:
-            error = True
-            try:
-                setblock(formNoteBlock(height2note[i[0]], instrument), [startpos[0], startpos[1] + 1, startpos[2]])
-                setblock(Block("universal_minecraft", instuments[i[0]][1]), startpos)
-                error = False
-            except ValueError:
-                log("无法放置音符：" + str(i) + '于' + str(startpos))
-                setblock(Block("universal_minecraft", baseblock), startpos)
-                setblock(Block("universal_minecraft", baseblock), [startpos[0], startpos[1] + 1, startpos[2]])
-            finally:
-                if error is True:
-                    log("无法放置音符：" + str(i) + '于' + str(startpos))
-                    setblock(Block("universal_minecraft", baseblock), startpos)
-                    setblock(Block("universal_minecraft", baseblock), [startpos[0], startpos[1] + 1, startpos[2]])
-            delay = int(i[1] * speed + 0.5)
-            if delay <= 4:
-                startpos[0] += 1
-                setblock(formRepeater(delay, 'west'), [startpos[0], startpos[1] + 1, startpos[2]])
-                setblock(Block("universal_minecraft", baseblock), startpos)
-            else:
-                for j in range(int(delay / 4)):
-                    startpos[0] += 1
-                    setblock(formRepeater(4, 'west'), [startpos[0], startpos[1] + 1, startpos[2]])
-                    setblock(Block("universal_minecraft", baseblock), startpos)
-                if delay % 4 != 0:
-                    startpos[0] += 1
-                    setblock(formRepeater(delay % 4, 'west'), [startpos[0], startpos[1] + 1, startpos[2]])
-                    setblock(Block("universal_minecraft", baseblock), startpos)
-            startpos[0] += posadder[0]
-            startpos[1] += posadder[1]
-            startpos[2] += posadder[2]
-
-    # e = True
-    try:
-        placeNoteBlock()
-        # e = False
-    except:  # ValueError
-        log("无法放置方块了，可能是因为区块未加载叭")
-    # finally:
-    #     if e:
-    #         log("无法放置方块了，可能是因为区块未加载叭")
-    level.save()
-    level.close()
-
-
-class ryStruct:
-
-    def __init__(self, world: str) -> None:
-
-        self.RyStruct = dict()
-        self._world = world
-        self._level = amulet.load_level(world)
-
-    def reloadLevel(self):
-        # e = True
-        try:
-            self._level = amulet.load_level(self.world)
-            # e = False
-        except:  # ValueError
-            log("无法重载地图")
-        # finally:
-        #     if e:
-        #         log("无法重载地图")
-
-    def closeLevel(self):
-        # e = True
-        try:
-            self._level.close()
-            # e = False
-        except:  # ValueError
-            log("无法关闭地图")
-        # finally:
-        #     if e:
-        #         log("无法重载地图")
-
-    def world2Rys(self, startp: list, endp: list, includeAir: bool = False):
-        """将世界转换为RyStruct字典，注意，此函数运行成功后将关闭地图，若要打开需要运行 reloadLevel
-        :param startp: [x,y,z] 转化的起始坐标
-        :param endp  : [x,y,z] 转换的终止坐标，注意，终止坐标需要大于起始坐标，且最终结果包含终止坐标
-        :param includeAir : bool = False 是否包含空气，即空气是否在生成之时覆盖地图内容
-        :return dict RyStruct """
-
-        level = self._level
-
-        for x in range(startp[0], endp[0] + 1):
-            for y in range(startp[1], endp[1] + 1):
-                for z in range(startp[2], endp[2] + 1):
-
-                    RyStructBlock = dict()
-
-                    cx, cz = bc2cc(x, z)
-                    chunk = level.get_chunk(cx, cz, "minecraft:overworld")
-                    universal_block = chunk.block_palette[chunk.blocks[x - 16 * cx, y, z - 16 * cz]]
-                    if universal_block == Block("universal_minecraft", "air") and includeAir:
-                        continue
-                    universal_block_entity = chunk.block_entities.get((x, y, z), None)
-
-                    RyStructBlock["block"] = str(universal_block)
-                    RyStructBlock["blockEntity"] = str(universal_block_entity)
-
-                    log("载入方块数据" + str(RyStructBlock))
-
-                    self.RyStruct[(x, y, z)] = RyStructBlock
-
-        level.close()
-
-        return self.RyStruct
-
-
-"""
-RyStruct = {
-    (0,0,0) = {
-        "block": str 完整的方块结构
-        "blockEntity": str | 'None'
-    }
-}
-"""

msctspt/values.py

@@ -1,56 +0,0 @@
-# 诸葛亮与八卦阵帮忙修改语法 日期：---2022年1月19日
-# 统计：致命（三级）错误：0个；警告（二级）错误：0个；语法（一级）错误：40个
-
-instuments = {
-    'note.banjo': ['班卓琴', 'hay_block'],
-    'note.bass': ['贝斯', 'planks'],
-    'note.bassattack': ['低音鼓/贝斯', 'log'],
-    'note.bd': ['底鼓', 'stone'],  # 即basedrum
-    'note.bell': ['铃铛/钟琴', 'gold_block'],
-    'note.bit': ['比特/“芯片”(方波)', 'emerald_block'],
-    'note.chime': ['管钟', 'packed_ice'],
-    'note.cow_bell': ['牛铃', 'soul_sand'],
-    'note.didgeridoo': ['迪吉里杜管', 'pumpkin'],
-    'note.flute': ['长笛', 'clay'],
-    'note.guitar': ['吉他', 'wool'],
-    'note.harp': ['竖琴/钢琴', 'concrete'],  # 任意其他类型的方块皆可
-    'note.hat': ['击鼓沿/架子鼓', 'glass'],
-    'note.iron_xylophone': ['“铁木琴”(颤音琴)', 'iron_block'],
-    'note.pling': ['“扣弦”(电钢琴)', 'glowstone'],
-    'note.snare': ['小军鼓', 'sand'],
-    'note.xylophone': ['木琴', 'bone_block']
-}
-'''乐器对照表\n
-乐器英文:[中文, 对应音符盒下方块名称]
-注：方块仅取一个'''
-
-height2note = {
-    0.5: 0,
-    0.53: 1,
-    0.56: 2,
-    0.6: 3,
-    0.63: 4,
-    0.67: 5,
-    0.7: 6,
-    0.75: 7,
-    0.8: 8,
-    0.84: 9,
-    0.9: 10,
-    0.94: 11,
-    1.0: 12,
-
-    1.05: 13,
-    1.12: 14,
-    1.2: 15,
-    1.25: 16,
-    1.33: 17,
-    1.4: 18,
-    1.5: 19,
-    1.6: 20,
-    1.7: 21,
-    1.8: 22,
-    1.9: 23,
-    2.0: 24,
-}
-'''音高对照表\n
-MC音高:音符盒音调'''

nmcsup/NFC Dev Log.txt

@@ -1,72 +0,0 @@
-从此日志开始，我的世界函数音乐构建更名为 函数音创 NoteFunCreater（谐音NotFun[狗头]），版本号更为0.1.0开始
-
-注意，运行此文件需要第三方库：
-1. mido 用于对midi文件的解码
-2. py7zr 用于对7z压缩包的压缩与解压等（需pycparser, cffi, texttable, pyzstd, pyppmd, pycryptodomex, multivolumefile, brotli, bcj-cffi支持）  -(从0.1.3开始不需要)
-3. zipfile 用于自动生成函数包的压缩
-4. pystray 用于支持窗口任务栏
-5. pillow （相当于Python2的PIL）用于绘图
-
-
-	0.1.0
-2021 7 10 - 2021 7 12
-1.程序窗口化
-2.仅支持基本的菜单操作
-3.程序文件皆储存至其相应目录下
-4.程序./bin/目录下文件将会自动防修改
-5.删除了彩蛋
-
-
-	0.1.1
-2021 7 14
-1.新增版本辨别的提示
-2.窗口中显示歌曲信息
-
-
-	0.1.2
-2021 7 14 - 2021 7 15
-1.在没运行过的机器上会自动安装库
-2.从midi导入时不会删除其他音轨
-3.改进UI样式
-4.支持对于单个音轨设置的修改以及音乐主设置的修改
-5.当未保存便退出时，会询问存储
-6.新增加载进度提示
-
-
-	0.1.3
-2021 7 15 - 2021 7 19
-1.不再从文件中读取音符及乐器信息（所以包更小了）
-2.改进UI
-3.修复了修改玩家选择器时变更了音乐标题的bug
-4.新增删除当前选定音轨按钮
-5.新增重置设置按钮（将音乐总设置设置为开始时的设置）
-6.运用多线程加载函数与文件等，程序运行效率更高
-7.修复变量作用域混淆问题
-
-
-	0.1.3.1
-2021 7 19
-1.修复了菜单中无法退出程序的问题
-
-
-	0.1.4
-2021 7 22
-1.支持显示指令于列表中
-
-
-
-
-
-
-	TO-DO
-1.支持从midi文件的元信息中收取音符信息并自动生成
-2.支持生成zip函数包
-3.支持使用WebSocket接口自动播放已编辑的音乐
-4.可以编辑多个项目
-5.能够自动将一个长串的音乐分成多个函数文件
-6.支持用户导入自己的乐器
-7.支持汇报崩溃记录（通过邮件附件的方式）
-8.支持播放字幕
-9.支持任务栏角标与通知
-10.将控制台版本的彩蛋移植到此版本，开启了任务栏
-11.可编辑音符

nmcsup/NMC Dev Log.txt

@@ -1,36 +0,0 @@
-世界音创(NoteMapCreater)是金羿开发的一款用于生成我的世界中各类有关音乐的物件的软件
-软件禁止商用，源代码始终公开，如使用未经授权的音乐经过此软件生成的任何物件侵犯了他人权利与本软件及其作者无关
-
-Copyright © W-YI 2021
-
-开头，特别感谢：
-KCINE：提供Cinemusicedit函数包(虽然函数包没怎么用过)
-Charlie_Ping：提供MusiCreaterBot(音乐地图生成QQ机器人)源码核心以及时不时的催更(虽然源码没有抄)
-金羿(作者本人)：提供NoteFunCreater(函数音创)的制作经验以及时不时的摸鱼(虽然不是很支持函数音创)
-广大群友：高效的催更作业让我以蜗牛的速度前进
-
-	Alpha 0.0.0
-2021 8 1 - 2021 8 10
-1.确定了大概的功能
-2.不支持无参数传入
-3.可以查看帮助，但是帮助大多功能没实现
-4.可以从格式文本、midi文件、钢琴声音MP3导入音轨
-5.可以生成一些方块到世界里，但是没有播放器(半支持bw开关)
-5.提供了修改文件地址的方法，但是不能修改
-
-	Alpha 0.0.1
-2021 8 10
-1.可以从函数音创的工程文件读取音轨
-2.可以新建一个空白世界来生成
-3.支持修改输出文件地址
-4.支持修改输出方块起始位置
-5.支持指定播放乐器，执行实体，执行积分板，播放玩家选择器
-6.可以生成指令音乐地图(完全支持-w开关)
-
-	Beta 0.0.0
-2021 8 X?
-1.除了-nw 和 -f 开关不支持以外都支持了
-
-	Beta 0.0.1
-2021 8 19
-1.修复了大量bug