星星，行星和恒星系 Stars, planets and stellar systems

该 Mod 添加了对星系运转的模拟，日月和行星的位置将遵从开普勒公式，而遥远的星辰则锚定在天球上。
日月行星的轨道数据跟随服务器数据，在玩家加入时分发给玩家；绝大部分轨道参数都是可以修改的，包括自转轴、轨道半长轴、轨道离心率、轨道倾角、近心点俯角、升交点经度。
该 Mod 添加了一个全局计时器，用于同步服务端和客户端的时钟，服务端的时间流速通过config中的timeAcceleration进行设置。

This mod adds a simulation of the galaxy's operation. The positions of the sun, moon, and planets will follow Kepler's formulas, while distant stars are anchored to the celestial sphere.
The orbital data of the sun, moon, and planets follow the server data and are distributed to players when they join. Most of the orbital parameters can be modified, including the axis of rotation, semi - major axis of the orbit, orbital eccentricity, orbital inclination, argument of periapsis, and longitude of the ascending node.
This mod adds a global timer to synchronize the clocks of the server and clients. The time flow rate of the server is set through the "timeAcceleration" in the config.

甜品内容 Dessert content

道具“天文手稿”（Astronomical Manuscript），标注了星系中行星的相对位置和一些描述内容（你可以通过资源包修改它）。
望远镜升级！你可以看到星星的名字。
添加了流星效果，在天幕中的发生概率默认为0.2，这个概率可以通过config中的meteorProbability修改。

The prop "Astronomical Manuscript" marks the relative positions of planets in the galaxy and some descriptive content (you can modify it through the resource pack).
The telescope has been upgraded! You can see the names of the stars.
A meteor effect has been added. The default probability of its occurrence in the sky is 0.2, and this probability can be modified through the meteorProbability in the config.

设置和自定义

现在该mod是基于数据包和资源包驱动的。
如何修改星系结构：在数据包/data/readstar/custom/planets/system.json中写入你自定义的星系树。
例如默认的星系树：

Currently, this mod is driven by data packs and resource packs.
How to modify the galaxy structure: Write your custom solar system tree in the /data/readstar/custom/planets/system.json file in the data pack.
For example, the default solar system tree:

{
  "Sun": {
    "Earth": {
      "Moon": {}
    },
    "Mars": {}
  }
}

这构建了一个Sun星系，有Earth，Mars两颗行星，其中Earth有一个Moon卫星。该json设置对大小写不敏感。
同时在和system.json同一级的文件夹中，要包含所有行星的具体数据，以Sun为例：

This constructs a Sun system with two planets, Earth and Mars. Among them, Earth has a satellite called Moon. This JSON setting is case-insensitive.
Meanwhile, in the same folder as system.json, specific data for all planets should be included. Taking Sun as an example:

{
  "mass": 2e30,
  "radius": 6.955e8,
  "axis": [0.0, 0.0, 0.0],
  "a": 0.0,
  "e": 0.0,
  "i": 0.0,
  "w": 0.0,
  "o": 0.0,
  "M0": 0.0
}

其中a为轨道半长轴，e为轨道离心率，i是轨道倾角，w是近心点俯角， o是升交点经度。 axis是行星自转轴指向，若axis长度为0，则认为axis = [0, 1, 0]。

Among them, a is the semi - major axis of the orbit, e is the orbital eccentricity, i is the orbital inclination, w is the argument of periapsis, and o is the longitude of the ascending node. The axis indicates the direction of the planet's rotation axis. If the length of the axis is 0, then the axis = [0, 1, 0].

如何修改星星内容：在资源包中/assets/readstar/custom/stars/stars.json中写入你自定义的星星，该文件的结构为：

How to modify star content: Write your custom stars in /assets/readstar/custom/stars/stars.json in the resource pack. The structure of this file is:

{
  "Stars": [
    
    ]
}

其中Stars是一个列表，每一个星星的格式例如：

{
  "name": "Sirius",
  "position": [
    -0.18745523,
    0.9392175288,
    -0.2876299192
  ],
  "type": 1,
  "Vmag": -1.44
}

其中position是星星的方向矢量，若长度不为1则缩放为1；type是星星的贴图种类，Vmag是视星等。
一个正确的stars.json文件例如：

Among them, position is the direction vector of the star. If its length is not 1, it will be scaled to 1; type is the texture type of the star, and Vmag is the apparent magnitude. An example of a correct stars.json file is as follows:

{
  "Stars": [
    {
      "name": "Sirius",
      "position": [
        -0.18745523,
        0.9392175288,
        -0.2876299192
      ],
      "type": 1,
      "Vmag": -1.44
    },
    {
      "name": "Canopus",
      "position": [
        -0.0632226532,
        0.6027419504,
        -0.7954275815
      ],
      "type": 8,
      "Vmag": -0.62
    },
    {
      "name": "Arcturus",
      "position": [
        -0.7837870542,
        -0.5269869065,
        0.3285767094
      ],
      "type": 5,
      "Vmag": -0.05
    }
  ]
}

行星和星星的贴图保存在资源包 /assets/readstar/textures/environment/ 下，向其中加入行星贴图以适配自定义的星系结构，注意行星（非星系中央天体）需要的贴图类似原版月亮贴图：

The textures of planets and stars are stored in the resource pack under /assets/readstar/textures/environment/. Add planet textures to it to adapt to the custom galaxy structure. Note that the textures required for planets (non-central celestial bodies of the system) are similar to the original moon textures:

而中央天体则类似太阳贴图。

The central celestial body is similar to a sun texture map.

为了修改星星贴图，需要修改该目录下的stars.png和starlight.png，代表了主题颜色和高视星等下的眩光效果，它们默认长这样：

To modify the star texture, you need to modify stars.png and starlight.png in this directory. They represent the theme color and the glare effect under high apparent magnitude. By default, they look like this:

可以修改这两个文件为任意想要的内容，只要把对应位置的贴图替换，注意每个款式包括了32*32像素。所有的这一切都可以添加数据包和资源包完成！

You can modify the contents of these two files as you like. Just replace the textures at the corresponding positions. Note that each style consists of 32*32 pixels. All of this can be done by adding data packs and resource packs!

欢迎交流：QQ 1210136901。

画廊