完善客户端功能并同步差距文档

extension/src/metin2_world.h

@@ -3,6 +3,7 @@
 #include <godot_cpp/classes/image.hpp>
 #include <godot_cpp/classes/node3d.hpp>
 #include <godot_cpp/classes/ref.hpp>
+#include <godot_cpp/variant/array.hpp>
 #include <godot_cpp/variant/dictionary.hpp>
 #include <godot_cpp/variant/string.hpp>
 
@@ -84,7 +85,15 @@ public:
 	// attr.atr 属性字节（bit0=BLOCK, bit1=WATER…）；地图外返回 0。
 	int sample_attribute(double gx_m, double gz_m) const;
 	bool is_blocked(double gx_m, double gz_m) const { return (sample_attribute(gx_m, gz_m) & 1) != 0; }
+	// ClientVS22 InstanceBaseMotion::GetFishingRot 等价：在角色前方 600cm
+	// 按当前 heading ±(0..180°，步长 10°) 扫描 ATTRIBUTE_WATER。
+	// 返回选中的服务端 heading；没有水面或目标区块未加载时返回 -1。
+	double get_fishing_rotation(double gx_m, double gz_m, double heading_deg) const;
+	bool can_fishing_position(double gx_m, double gz_m, double heading_deg) const;
 	godot::Dictionary get_load_report() const;
+	// Area ambience sources from AreaAmbienceData + .pra properties. Audio owns
+	// playback; the world only exposes the reference source records.
+	godot::Array get_ambience_sources() const;
 
 	// 便捷：解一张 DDS 为 Image（HUD 小地图等用；Godot 原生不支持 .dds）。
 	godot::Ref<godot::Image> load_dds(const godot::String &path) const;
@@ -144,13 +153,26 @@ private:
 		godot::Node3D *root = nullptr; // 该区块的全部场景节点（terrain + water + 对象 + 树）
 		int objects = 0, trees = 0;
 	};
+	struct AmbienceSource {
+		int tile_x = 0, tile_y = 0;
+		int object_index = 0;
+		godot::Vector3 position;
+		int range_cm = 0;
+		float max_volume_area_percentage = 0.0f;
+		float play_interval = 0.0f;
+		float play_interval_variation = 0.0f;
+		godot::String play_type;
+		std::vector<std::string> sounds;
+	};
 	std::vector<Chunk> chunks;
 	std::vector<std::pair<int, int>> stream_queue; // 待建区块
+	std::vector<AmbienceSource> ambience_sources;
 	int stream_budget = 1;                          // 每帧最多建几个区块（streaming 时）
 
 	godot::String map_dir() const;
 	bool build_chunk(int tx, int ty);
 	void place_chunk_objects(int tx, int ty, godot::Node3D *root, int &n_obj, int &n_tree);
+	void place_chunk_ambience(int tx, int ty);
 	void unload_chunk(int idx);
 	void stream_update();
 	const Chunk *chunk_at(int tx, int ty) const;