Fabric Wiki

User Tools

Site Tools

Trace:
tutorial:side

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
tutorial:side [2020/02/22 16:14] – [Side] History lessons are not required jamieswhiteshirttutorial:side [2022/04/13 04:32] (current) – external edit 127.0.0.1
Line 10: Line 10:
 ===== Physical Sides  ===== ===== Physical Sides  =====
  
-The physical sides or the environment refer to the two distributions (jars) of Minecraft game, the client (what the vanilla launcher launches) and the server (download available on [[https://minecraft.net]] for free). A physical side refers to which code is available in the current environment.+The physical sides or the environment refer to the two distributions (jars) of Minecraft, the client (what the vanilla launcher launches), and the server (download available on [[https://minecraft.net]] for free). A physical side refers to which code is available in the current environment.
  
 The client and server environment are minified distributions of the same program, containing only the required parts of the code.  The client and server environment are minified distributions of the same program, containing only the required parts of the code. 
Line 22: Line 22:
 ===== Logical Sides ===== ===== Logical Sides =====
  
-Logical sides are about the actual game logic.  +The logical sides are responsible for the actual game logic.  
-The logical client does rendering, sends player inputs to the server, handles resource packs and partially simulates the game world. The server handles the core game logic, data packs and maintains the true state of the game world.+The logical client does rendering, sends player inputs to the server, handles resource packs, and partially simulates the game world. The server handles the core game logic, data packs, and maintains the true state of the game world.
  
-The client maintains a partial replica of the server's world, with copies of objects such as:<code> +The client maintains a partial replica of the server's world, with copies of objects such as:<yarncode> 
-net.minecraft.world.World +net.minecraft.class_1937 
-net.minecraft.entity.Entity +net.minecraft.class_1297 
-net.minecraft.block.entity.BlockEntity +net.minecraft.class_2586 
-</code> +</yarncode> 
-These replicated objects allow clients and servers to perform some common game logic. The client can interact with these objects while the server is responsible for keeping them in sync. Usually, to distinguish objects on the logical clients from the ones on the logical server, access the world of the object and check its 'isClient' field. This can be used to perform authoritative actions on the server such as spawning entities, and to simulate actions on the client. This technique is necessary to avoid desynchronization between the two logical sides.+These replicated objects allow clients and servers to perform some common game logic. The client can interact with these objects while the server is responsible for keeping them in sync. Usually, to distinguish objects on the logical clients from the ones on the logical server you would access the world of the object and check its ''isClient'' field. This can be used to perform authoritative actions on the server such as spawning entities, and to simulate actions on the client. This technique is necessary to avoid desynchronization between the two logical sides.
 ===== Detailed look into all sides ===== ===== Detailed look into all sides =====
  
-With an understanding of which sides there are and how to distingish between them, we can now look into every single side with a detailed look.+With an understanding of which sides there are and how to distinguish between them, we can now look at each side in detail.
  
 ==== Physical Client ==== ==== Physical Client ====
 The physical client is the minecraft jar downloaded by the vanilla launcher. It contains a logical client and a logical server (integrated server). Its entrypoint is ''net.minecraft.client.main.Main''. The physical client is the minecraft jar downloaded by the vanilla launcher. It contains a logical client and a logical server (integrated server). Its entrypoint is ''net.minecraft.client.main.Main''.
  
-As a physical client can load several different worlds each within a separate logical server, but only one at a time.+A physical client can load several different worlds, each within a separate logical server, but only one at a time.
  
 Compared to the logical server of the physical server (dedicated server), the logical server of the physical client (integrated server) can be controlled by the logical client on the physical client (e.g., F3+T reloads data packs and shutting down the client also shuts down the integrated server). It can also load resource packs bundled in a world to the logical client on the physical client. Compared to the logical server of the physical server (dedicated server), the logical server of the physical client (integrated server) can be controlled by the logical client on the physical client (e.g., F3+T reloads data packs and shutting down the client also shuts down the integrated server). It can also load resource packs bundled in a world to the logical client on the physical client.
  
-All the logical client contents are exclusive to the physical client. Hence, you see many environment annotations on rendering, sound, and other logical client code.+All the logical client content is exclusive to the physical client, therefore you see many environment annotations on rendering, sound, and other logical client code.
  
 Some mods target physical clients exclusively, for instance, Liteloader, Optifine, and Minecraft PvP clients (Badlion, Hyperium). Some mods target physical clients exclusively, for instance, Liteloader, Optifine, and Minecraft PvP clients (Badlion, Hyperium).
Line 52: Line 52:
 Its logical server differs slightly from that of a physical client as only one logical server instance is ever present when the physical server is running. Moreover, the logical server of the physical server can be controlled remotely via Rcon, has a config file called server.properties, and can send server resource packs. Its logical server differs slightly from that of a physical client as only one logical server instance is ever present when the physical server is running. Moreover, the logical server of the physical server can be controlled remotely via Rcon, has a config file called server.properties, and can send server resource packs.
  
-Despite these differences, most mods are applicable without problems to the logical servers of both the physical client and the physical server as long as they do not refer to logical client contents.+Despite these differences, most mods are applicable without problems to the logical servers of both the physical client and the physical server as long as they do not refer to logical client content.
  
 Its features of single world and resource pack sending, however, make vanilla mod (data pack and resource pack combination) installation much easier compared to on clients, as vanilla physical clients set up when connecting to the server automatically. Its features of single world and resource pack sending, however, make vanilla mod (data pack and resource pack combination) installation much easier compared to on clients, as vanilla physical clients set up when connecting to the server automatically.
Line 59: Line 59:
  
 ==== Logical Client ==== ==== Logical Client ====
-The logical client is the interface to the player. Rendering (LWJGL), resource pack, player input handling, and sounds, happen on the logical client. It is not present on the physical server.+The logical client is the interface to the player. Rendering (LWJGL), resource pack, player input handling, and sounds happen on the logical client. It is not present on the physical server.
  
 ==== Logical Server ==== ==== Logical Server ====
-The logical server is where most of the game logic is executed. Data packs, world updates, block entity and entity ticks, mob AI, game/world saving,  and world generation, happen on the logical server.+The logical server is where most of the game logic is executed. Data packs, world updates, block entity and entity ticks, mob AI, game/world-saving,  and world generation, happen on the logical server.
  
 The logical server on the physical client is called the "Integrated Server", while the logical server on the physical server is called the "Dedicated Server" (which is also the name of the physical server itself). The logical server on the physical client is called the "Integrated Server", while the logical server on the physical server is called the "Dedicated Server" (which is also the name of the physical server itself).
  
-The logical server runs in its own main thread, even on physical servers, and has a few worker threads. The lifetime of a logical server depends on the physical side it is hosted on. On a physical server, a logical server exists for as long as long as the process is running. On a physical client, multiple logical servers may be created, but only one logical server may exist at a time. A new logical server is created when the player loads a local save and closed when the player closes the local save.+The logical server runs in its own main thread, even on physical servers, and has a few worker threads. The lifetime of a logical server depends on the physical side it is hosted on. On a physical server, a logical server exists for as long as the process is running. On a physical client, multiple logical servers may be created, but only one logical server may exist at a time. A new logical server is created when the player loads a local save and closed when the player closes the local save.
  
 Most universal mods target the logical server so that they can work both in single player and multi player scenarios. Most universal mods target the logical server so that they can work both in single player and multi player scenarios.
 ===== Communication===== ===== Communication=====
  
-The only correct way to exchange data between logical clients and servers by exchanging packets. The packets (as documented on [[https://wiki.vg]]) are sent between logical clients and logical servers, not physical sides. Mods can add packets to transfer custom information between two logical sides. Packets are exchanged in-memory for a logical client connected to its own integrated server, and exchanged over a networking protocol otherwise.+The only correct way to exchange data between logical clients and servers is by exchanging packets. The packets (as documented on [[https://wiki.vg]]) are sent between logical clients and logical servers, not physical sides. Mods can add packets to transfer custom information between two logical sides. Packets are exchanged in-memory for a logical client connected to its own integrated server, and exchanged over a networking protocol otherwise.
  
 Logical clients send C2S (Client-To-Server) packets to the logical server. Logical clients send C2S (Client-To-Server) packets to the logical server.
tutorial/side.1582388053.txt.gz · Last modified: 2020/02/22 16:14 by jamieswhiteshirt