Merge pull request #24221 from YeldhamDev/deprecate_animation_tree_player

Warn about AnimationTreePlayer's deprecation

scene/animation/animation_tree_player.cpp

@@ -401,6 +401,9 @@ void AnimationTreePlayer::_notification(int p_what) {
 
 		case NOTIFICATION_ENTER_TREE: {
 
+			ERR_EXPLAIN("AnimationTreePlayer has been deprecated. Use AnimationTree instead.");
+			WARN_DEPRECATED
+
 			if (!processing) {
 				//make sure that a previous process state was not saved
 				//only process if "processing" is set
@@ -409,12 +412,14 @@ void AnimationTreePlayer::_notification(int p_what) {
 			}
 		} break;
 		case NOTIFICATION_READY: {
+
 			dirty_caches = true;
 			if (master != NodePath()) {
 				_update_sources();
 			}
 		} break;
 		case NOTIFICATION_INTERNAL_PROCESS: {
+
 			if (animation_process_mode == ANIMATION_PROCESS_PHYSICS)
 				break;
 
@@ -1715,6 +1720,11 @@ Error AnimationTreePlayer::node_rename(const StringName &p_node, const StringNam
 	return OK;
 }
 
+String AnimationTreePlayer::get_configuration_warning() const {
+
+	return TTR("This node has been deprecated. Use AnimationTree instead.");
+}
+
 void AnimationTreePlayer::_bind_methods() {
 
 	ClassDB::bind_method(D_METHOD("add_node", "type", "id"), &AnimationTreePlayer::add_node);

scene/animation/animation_tree_player.h

@@ -343,6 +343,8 @@ public:
 	int node_get_input_count(const StringName &p_node) const;
 	StringName node_get_input_source(const StringName &p_node, int p_input) const;
 
+	String get_configuration_warning() const;
+
 	/* ANIMATION NODE */
 	void animation_node_set_animation(const StringName &p_node, const Ref<Animation> &p_animation);
 	Ref<Animation> animation_node_get_animation(const StringName &p_node) const;