English | 中文
PyCraft based Replay Client
A Minecraft client that can record a replay file (*.mcpr) which can be recognized by Replay Mod
Great thanks to SARC for the replay logic stuffs and pyCraft for the minecraft client stuffs
Python version should be python3 and at least it works on Python 3.6 and Python 3.8
- cryptography
- requests
- pynbt
- redbaron
- colorlog
- ruamel.yaml
The requirements are also stored in requirements.txt
PCRC currently supports connecting to vanilla Minecraft server. Supported versions:
- 1.12 / 1.12.2
- 1.14.4
- 1.15.2
- 1.16.1 ~ 1.16.5
- 1.17.1
- 1.18 ~ 1.18.2
- Can be hosted server side for 24/7 recording
- Has way less performance usage than a regular Minecraft client
- It can be set to record only when the player is nearby
- Multiple options can be set for custom recording
- Restart after raw file size reaches 2048MB or recording time reaches 5 hours to prevent oversize recording
- Since the virtual player (bot) doesn't move, the recording file will not include unnecessary packets related to chunk loading, which can significantly reduce recording file size
- Download and unzip the latest PCRC in Release page
- Run
python PCRC.pyz
orPCRC.exe
- On first start, PCRC will generate default config file and exit. Fill in the config file on demand before launch it again
- Input
start
in the console to start PCRC - (Recommand) Set the gamemode of the PCRC bot to spectator
- Use console or chat in game to control PCRC
Requires MCDReforged >= 2.0
Put the PCRC.pyz
downloaded from Release into the plugin folder of MCDR and that's it
NOTE: Unloading the plugin will cause PCRC to stop recording and exit the game
The config file is config.json
. All settings can be changed in it. Those which are similar to ABC inside it are just comments, don't need to modify them
When used as a plugin for MCDR, the path to the configuration file will be config/pcrc/config.json
, and config/pcrc/mcdr_config.json
store the configuration related to MCDR
language
: The language that the PCRC bot will speak in the game. Language file should be in folder lang/
recording_temp_file_directory
: Path to the directory where PCRC will store its temporary recording files in
recording_storage_directory
: Path to the directory where PCRC will save its finished recording files
debug_mode
: Whether outputs debug info or not
authenticate_type
: The way for PCRC to login your account. It can be offline
, mojang
or microsoft
, respectively corresponding to offline account, Mojang account login and Microsoft account login
If you use Microsoft account login, when you connect to the server for the first time after startup, you need to log in with your Microsoft account according to the console output
username
: The username for offline mode login, or the email address of the Minecraft account if you are using mojang
type online mode login
password
: The password of the Minecraft account if you are using mojang
type online mode login
address
: IP Address of the Minecraft server
port
: Port of the Minecraft server
server_name
: The server name showed in replay viewer
initial_version
: The preferred Minecraft version that used to connect to bungeecord like server
Examples for those account related config entries:
// Log in with offline mode
{
"authenticate_type": "offline",
"username": "MyPlayerName", // the player name you want to use
"password": "", // This entry will not be used and will be ignored
}
// Log in with mojang account
{
"authenticate_type": "mojang",
"username": "[email protected]", // your mojang account email address
"password": "mypassword", // your mojang account password
}
// Log in with microsoft account
{
"authenticate_type": "microsoft",
"username": "", // This entry will not be used and will be ignored
"password": "", // This entry will not be used and will be ignored
}
login-command
: A list of messages to send to the server when joined. Useful for servers with custom in-game login methods. Default: []
file_size_limit_mb
: The limit of size of the .tmcpr
file. Every time it is reached, PCRC will restart. Default: 2048
file_buffer_size_mb
: The limit of size of file buffer. Every time it is reached, PCRC will flush all content in the buffer into .tmcpr
file. Default: 8
time_recorded_limit_hour
: The limit of actual recording time. Every time it is reached, PCRC will restart. Default: 12
delay_before_afk_second
: The time delay between every player leaving and PCRC pausing recording. Default: 15
afk_ignore_spectator
: If set to true, PCRC will ignore all packets from spectator players when determining if it should pause recording due to all players have left. Default: true
record_packets_when_afk
: If set to false, PCRC will ignore almost every incoming packets when PCRC pauses recording (SARC's behavior). This can decrease the replay file size a lot but might cause block / entity desync if there will be something happening after player leaves. Default: true
auto_relogin
: If this option is enabled, and the client gets disconnected, PCRC will automatically try to reconnect
auto_relogin_attempts
: The maximum amount of relogin attempts before login success . Default: 5
chat_spam_protect
: Automatically delay between sending chat messages if necessary to prevent being kicked for spamming
command_prefix
: Any chat message starts with command_prefix
will be recognize as a command to control PCRC. Default: !!PCRC
daytime
: Sets the daytime once to the defined time in the recording and ignores all further changes from the server. If set to -1
the normal day/night cycle is recorded
weather
: Turns weather in the recording on or off
with_player_only
: If set to true, PCRC only record packets if there are players nearby
remove_items
: If set to true, all dropped items wont be recorded
remove_bats
: If set to true, bats won't be recorded
remove_phantoms
: If set to true, phantoms won't be recorded
enabled
: Whether to enable whitelist
whitelist
: Whitelist player list
Command prefix !!PCRC
can be customized in the config file
Available if launched directly
help
: Show the list of console command
start
: Start PCRC and start recording
stop
: Stop PCRC and stop recording
restart
: Restart PCRC
exit
: Exit the program
auth
: Authenticate with minecraft again. Used when the previous authentication failed
say <text>
: Send text <text>
to the server as a chat message
set <option> <value>
Set option to value of PCRC and in the config file
whitelist [on|off]
Switch the whitelist switch
whitelist [add|del] <player>
Add or delete a player to(from) the whitelist
whitelist status
To view the status of the whitelist and the whitelisted player(s)
status
: Show the status of PCRC
list
: Show the player list in the server if connected
Available if used as a MCDR plugin
!!PCRC start
: start PCRC and start recording
!!PCRC stop
: stop PCRC and stop recording. Only works with console command input
!!PCRC reload
: Reload the config file for MCDR
!!PCRC set_redirect_url <url>
: Input the url used in microsoft logging in
Requires permission level 1 to use these commands. The minimum required permission level can be set in the config file for MCDR
Using normal in game chatting to trigger
!!PCRC
: show help
!!PCRC status
: show status
!!PCRC here
: emit a "!!here" command
!!PCRC pos
: show position, might not be 100% accurate
!!PCRC spec
: use the teleport ability in spectator mode to teleport to the player who sent this command
!!PCRC stop
: stop PCRC
!!PCRC restart
: restart PCRC
!!PCRC set
: print all settable option
!!PCRC set <option> <value>
: set the value of <option>
to <value>
which won't write to config file
!!PCRC name <filename>
: set recording file name to <filename>
!!PCRC respawn
: let PCRC bot try to respawn
- There's not any code for processing game content in PCRC so if you want to move the PCRC bot you can only use teleport command like
!!PCRC spec
or/tp
. You can not use stuffs like piston to move the bot otherwise some wired behaviors like the bot become invisible may occur - The file size that PCRC shows when recording is the size of
.tmcpr
file, the uncompressed raw packet file size. It's not the size of the final recording file.mcpr
. The final file size is about 10% to 40% of the original packet file size, depending on the situation