1 Overview
1.1 The Network class
1.2 The Network::MessageTokenizer class
1.3 The Network::PacketParser class
1.4 The Network::Receive, Network::Send and Network::ClientReceive classes
1.5 The Network::Receive::ServerTypeX and Network::Send::ServerTypeX class
1.6 How it all works together
2 Handling multiple server types (message parser part)
2.1 Implementation details
2.1.1 Example 1: adding a new message handler
2.1.2 Example 2: handling a different server type
3 Handling multiple server types (message sender part)
4 Using the message sender
4.1 Compatibility notes
5 Hooks
5.1 "packet_pre/$HANDLER_NAME"
5.2 "packet/$HANDLER_NAME"
6 Appendix A: introduction to the Ragnarok Online protocol
7 Appendix B: recvpackets.txt and handling message lengths
8 Appendix C: obfuscation of outgoing messages
8.1 Padded packets
8.2 Encrypted message IDs
9 Original article
Overview
The OpenKore network subsystem roughly consists of the following classes:
The Network class
This is the connection manager. It manages the TCP/IP socket connection with the server, and handles things like connection, disconnection, sending data to the server, receiving data from the server, etc. But it doesn't do much else.
Schematically, it looks like this:
File:Network-subsystem.jpg
Upon connection to the server, it creates two objects:
A message parser object, which is of class Network::Receive::ServerTypeX. Whenever a message is received from the server, that message is passed to the message parser.
A message sender object (not seen in the above diagram), which is of class Network::Send::ServerTypeX. This is used for sending messages to the server.
There are several implementations of Network class: Network::DirectConnection, Network::XKore and Network::XKoreProxy.
The Network::MessageTokenizer class
This is a tokenizer class. It extracts discrete server or client messages from a byte stream passed by the connection manager. But it doesn't do much else.
The Network::PacketParser class
This is a base message parser class. It parses messages passed by the connection manager into hashes with message data, as well as does reverse operation - generates messages from hashes with message data. But it doesn't do much else.
Afterwards, parsed messages are handled by built-in handlers in following classes and, with hooks, by plugins or other modules.
Additionally, there is API for modifying or dropping messages to alter any further processing.
The Network::Receive, Network::Send and Network::ClientReceive classes
There classes are descendants of Network::PacketParser class.
Network::Receive and Network::Send are parser helper classes. They contain parser helpers which serve as a workaround in the absense of the capable parser subsystem.
Network::Receive and Network::ClientReceive are message handling classes. They contain built-in handlers for messages coming from the server (Network::Receive) or from the client (Network::ClientReceive), which store information from network messages to be used later in other modules (like the AI).
Network::Send is the message sender class. It encapsulates network messages into simple, easy-to-use functions to be used outside of network subsystem.
Any descendant ServerType class may customize message handlers and parser helpers, but they should refrain from that other than for servertype-specific features and debugging.
The Network::Receive::ServerTypeX and Network::Send::ServerTypeX class
These are serverType description classes. They describe network message identifiers and structures for different servers. But they shouldn't do much else.
Note that none of these classes, from the connection manager to the serverType descriptions, should contain any AI code.
How it all works together
Main initialization code creates a connection manager instance and a message tokenizer instance:
$net = new Network::DirectConnection;
$incomingMessages = new Network::MessageTokenizer(\%recvpackets);
Connection manager creates a packet parser instance:
$packetParser = Network::Receive->create($wrapper, $serverType);
Main loop passes information from connection manager $net to message tokenizer $incomingMessages:
$incomingMessages->add($net->serverRecv);
Message tokenizer with data and a message handler $packetParser are passed to a packet parser $packetParser to process all available messages:
@packets = $packetParser->process($incomingMessages, $packetParser);
# compare with outgoing packets:
# @packets = $messageSender->process($outgoingClientMessages, $clientPacketHandler);
Packets are passed back to the connection manager, which passes them to XKore clients:
$net->clientSend($_) for @packets;
Meanwhile, the packet parser calls custom parsers, hooks and built-in handlers:
my $custom_parser = $self->can("parse_$handler_name")
if ($custom_parser) {
$self->$custom_parser(\%args);
}
Plugins::callHook("packet_pre/$handler_
ภาพรวม 11.1 ระดับชั้นเครือข่าย1.2 การคลา Network::MessageTokenizer1.3 การคลา Network::PacketParser1.4 การเรียน Network::Receive, Network::Send และ Network::ClientReceive1.5 การคลา Network::Receive::ServerTypeX และ Network::Send::ServerTypeX1.6 วิธีทำงานทั้งหมดเข้าด้วยกัน2 การจัดการหลายชนิดเซิร์ฟเวอร์ (ข้อความส่วนตัวแยกวิเคราะห์)2.1 รายละเอียดดำเนินการ2.1.1 ตัวอย่าง 1: การเพิ่มตัวจัดการข้อความใหม่2.1.2 ตัวอย่าง 2: การจัดการชนิดเซิร์ฟเวอร์อื่น3 การจัดการหลายชนิดเซิร์ฟเวอร์ (ส่วนของผู้ส่งข้อความ)4 ใช้ผู้ส่งข้อความ4.1 หมายเหตุความเข้ากันได้แขวน 5 ตะขอ5.1 "packet_pre / $HANDLER_NAME"5.2 "แพคเก็ต / $HANDLER_NAME"ภาคผนวก a:แนะนำ 6 การโพรโทคอล Ragnarok Online7 ภาคผนวก b: recvpackets.txt และการจัดการข้อความยาว8 ภาคผนวก c: obfuscation ของข้อความขาออก8.1 แพคเก็ตบุ8.2 ข้อเข้ารหัสรหัสบทความต้นฉบับที่ 9ภาพรวมระบบย่อยเครือข่าย OpenKore ประมาณประกอบด้วยการเรียนต่อไปนี้:ระดับเครือข่ายจัดการการเชื่อมต่ออยู่ จัดการการเชื่อมต่อซ็อกเก็ต TCP/IP กับเซิร์ฟเวอร์ และจัดการกับสิ่งต่าง ๆ เช่นการเชื่อมต่อ หลุด ส่งข้อมูลไปยังเซิร์ฟเวอร์ รับข้อมูลจาก server ฯลฯ แต่มันไม่ได้ทำอื่น ๆ อีกมากมายSchematically มันมีลักษณะดังนี้:File:Network-subsystem.jpgเมื่อเชื่อมต่อกับเซิร์ฟเวอร์ สร้างวัตถุที่สอง:ข้อแยกวิเคราะห์วัตถุ ซึ่งเป็นของคลาส Network::Receive::ServerTypeX เมื่อได้รับข้อความจากเซิร์ฟเวอร์ ข้อความที่ถูกส่งผ่านไปแยกวิเคราะห์ข้อความข้อความผู้ส่งวัตถุ (ไม่เห็นในแผนภาพข้างต้น), ซึ่งเป็นของคลาส Network::Send::ServerTypeX นี้ใช้สำหรับการส่งข้อความไปยังเซิร์ฟเวอร์มีปฏิบัติการต่าง ๆ ของเครือข่ายระดับ: Network::DirectConnection, Network::XKore และ Network::XKoreProxyคลา Network::MessageTokenizerนี้เป็นคลา tokenizer แยกแยกเซิร์ฟเวอร์หรือไคลเอ็นต์ข้อความจากกระแสข้อมูลไบต์ผ่าน โดยตัวจัดการการเชื่อมต่อ แต่มันไม่ได้ทำอื่น ๆ อีกมากมายคลา Network::PacketParserนี้เป็นชั้นแยกวิเคราะห์ข้อความพื้นฐาน วิเคราะห์ข้อความที่ส่งผ่าน โดยตัวจัดการการเชื่อมต่อไปเรื่องกับข้อความข้อมูล เป็นตลอดจนย้อนกลับการดำเนินการ - สร้างข้อความจากเรื่องพร้อมข้อมูลข่าวสาร แต่มันไม่ได้ทำอื่น ๆ อีกมากมายหลังจากนั้น แยกวิเคราะห์ข้อความจะถูกจัดการ โดยตัวจัดการ ในชั้นเรียนต่อไปนี้ และ ตะขอ ปลั๊กอินหรือโมดูลอื่น ๆนอกจากนี้ มี API สำหรับแก้ไข หรือวางข้อความการเปลี่ยนแปลงใด ๆ การดำเนินการต่อไปเรียน Network::Receive, Network::Send และ Network::ClientReceiveเรียนไว้ให้ลูกหลานของคลา Network::PacketParserNetwork::Receive และ Network::Send เป็นตัวแยกวิเคราะห์ตัวช่วยเรียน พวกเขาประกอบด้วยตัวช่วยในการแยกวิเคราะห์ซึ่งเป็นการแก้ปัญหาใน absense ของระบบย่อยสามารถแยกวิเคราะห์Network::Receive และ Network::ClientReceive เป็นข้อความการจัดการชั้นเรียน พวกเขาประกอบด้วยในตัวจัดการสำหรับข้อความที่มา จากเซิร์ฟเวอร์ (Network::Receive) หรือ จากไคลเอนต์ (Network::ClientReceive), ซึ่งเก็บข้อมูลจากข้อความเครือข่ายที่จะใช้ในโมดูลอื่น ๆ (เช่น AI)Network::Send เป็นคลาผู้ส่งข้อความ มัน encapsulates ข้อความเครือข่ายเป็นง่าย ง่ายต่อการใช้ฟังก์ชั่นการใช้นอกระบบย่อยเครือข่ายชั้น ServerType เชื้อสายใด ๆ อาจกำหนดตัวจัดการข้อความและตัวช่วยในการแยกวิเคราะห์ แต่พวกเขาควรละเว้นจากที่อื่นที่ไม่ใช่สำหรับคุณลักษณะเฉพาะ servertype และแก้จุดบกพร่องคลา Network::Receive::ServerTypeX และ Network::Send::ServerTypeXเรียน serverType คำอธิบายเหล่านี้ได้ อธิบายระบุข้อความเครือข่ายและโครงสร้างสำหรับเซิร์ฟเวอร์ที่แตกต่างกัน แต่พวกเขาไม่ควรทำอื่น ๆ อีกมากมายโปรดสังเกตว่า ไม่มีคลาสที่เหล่านี้ จากตัวจัดการการเชื่อมต่อนั้น ๆ serverType ควรประกอบด้วยรหัสใด ๆ AIวิธีทำงานทั้งหมดเข้าด้วยกันรหัสหลักการเริ่มต้นสร้างจัดการการเชื่อมต่ออินสแตนซ์และอินสแตนซ์ข้อความ tokenizer:$net = Network::DirectConnection ใหม่$incomingMessages = Network::MessageTokenizer(\%recvpackets) ใหม่จัดการการเชื่อมต่อที่สร้างอินสแตนซ์ตัวแยกวิเคราะห์แพคเก็ต:$packetParser = Network::Receive -> สร้าง ($wrapper, $serverType);หลักส่งผ่านข้อมูลจากตัวจัดการการเชื่อมต่อ $net ถึงข้อ tokenizer $incomingMessages:$incomingMessages -> เพิ่ม ($net -> serverRecv);Tokenizer ข้อความข้อมูลและตัวจัดการข้อความ $packetParser จะผ่านไปที่แบ่งแพคเก็ต $packetParser การประมวลผลข้อความทั้งหมดที่มีอยู่:@packets = $packetParser -> กระบวนการ ($incomingMessages, $packetParser);อันดับเปรียบเทียบกับแพคเก็ตขาออก:# @packets = $messageSender -> กระบวนการ ($outgoingClientMessages, $clientPacketHandler);แพคเก็ตจะถูกส่งผ่านกลับไปจัดการการเชื่อมต่อ ซึ่งส่งพวกเขาไปยังไคลเอนต์ XKore:$net -> clientSend($_) สำหรับ @packetsในขณะเดียวกัน ตัวแยกวิเคราะห์ของแพคเก็ตเรียก parsers ที่กำหนดเอง ตะขอ และในตัวจัดการ:$custom_parser ของฉัน = $self -> can("parse_$handler_name")ถ้า{($custom_parser) $self -> $custom_parser(\%args)}Plugins::callHook ("packet_pre / $handler_
การแปล กรุณารอสักครู่..